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CHAPTER  1 
GENERAL 


1-1  *  *“££22* •  iMtructlon  provides  technical  Information  concerning 

the  concepts,  facilities,  and  use  of  the  multi-machine  scheduler  (MMS). 

Applicability.  This  instruction  applies  to  any  automatic  data 
processing  (ADP)  installation  desiring  an  automatic  scheduling  system. 

1-i.  Explanation  of  terms,  a.  MMS  network-all  processor  and  resources 
under  the  control  of  the  master  data  base. 


( 


*  b.  Master  data  base— contains  all  information  required  for  the 
scheduling  or  controlling  of  any  job  to  be  put  under  MMS  control.  The 
master  data  base  consists  of  the  job  and  network  files. 

c.  Master  matrix— used  interchangeably  with  master  data  base. 

*  d.  Run  matrix — a  data  base,  extracted  from  the  master  data  base,  that 
contains  information  required  for  scheduling  and  controlling  jobs 
established  under  MMS  control. 


*  e.  On-the-fly  update— the  ability  to  modify  the  run  matrix  dynamically 
while  jobs  under  MMS  are  executing. 

f.  Application— a  grouping  of  related  jobs  for  scheduling 

considerations  (for  example,  weekly  billing). 

g.  Job — a  grouping  of  programs  into  the  lowest  controllable  element  of 
the  system. 


h.  Predecessor  job — one  whose  functional  or  data  constraint  must  be 
met  prior  to  another  job  being  considered  for  scheduling. 

i.  Exclusive-use  mode — a  file  is  loaded,  unloaded,  or  updated  by  one 
or  more  steps  in  a  job  under  MMS  control.  MMS  will  not  release  other  users 
of  this  file  when  this  job  is  executing. 


j.  Share  mode — a  file  is  updated  by  one  or  more  steps  in  a  job  under 
MMS  control.  MMS  will  release  other  reference  users,  or  share  users,  of 
this  file  to  a  single  central  processing  unit  (CPU). 

k.  Update  mode — a  file  is  updated  by  one  or  more  steps  in  a  job  under 
MMS  control.  MMS  will  only  release  other  reference  users  of  this  file  when 
this  job  is  executing. 
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1.  Reference  node--a  file  li  reed  by  one  or  more  stepe  in  a  job  under 
itHS  control.  t^MS  will  release  other  reference,  update,  or  shore  users  of 
this  "lie  when  this  job  Is  executing. 

*  n>.  Operating  systems. 

(1)  K7T" i oultiple  variable  nuaber  of  tasks  (MVT). 

(2)  hVS — multiple  tasking  virtual  storage  system  (MVS). 

.1.  HASP— Houston  Automatic  Spooling  Process,  provides  a  more  efficient 
alternatlva  to  the  OS  functions  of  input  and  output  spooling. 

o.  3uiesca--to  inhibit  the  releasing  of  jobs  to  allow  the  system  tc 
dry  up. 

p.  AJiHUu — abaoraal  end  (termination)  of  a  program  either  with  a  system 
completion  code  (e .». ,  data  check),  or  «  user  completion  code,  greater  than 
43$. 

q.  T5‘j— the  tin"  sharing  option  used  to  provide  remote  scheduling 
capabilities. 

* 


1-4.  General .  a.  This  system  allows  the  user  to  dynamically  schedule 
externally,  as  wall  a3  internally,  the  processing  of  jots  within  any  type 
of  ACL1  environment.  It  will  perform  the  primary  functions  of  effective 
computer  use. 

*  b.  Complete  updating  and  reporting  capabilities  are  available  to  the 
user  including  temporary  and  permanent  rata  base  edification,  automatic 
data  base  updating  with  respect  to  job  statistics,  on-tha-fly  updating,  a 
variety  of  data  base  reports  Co  aid  those  scheduling  ot  controlling  the 
euvi ronment . 


c.  The  simulation  and  the  actual  control  at  execution  tics  .ill  u6e 
the  saue  scheduling  algorithm.  The  only  difference  --einfe  that  at 
simulation  tine  the  system  resources,  as  define^  tr  toe  tti  base,  are  used 
for  scheduliug;  aad  at  the  actual  Cine  of  execution,  c^e  'esour ces  within 
the  particular  computer  environment  are  used  for  scheduling  purposes. 

ft  u.  The  cyatem  can  be  operated  in  batch  '.node  or  remotely  by  a  terminal 
utilising  the  ISO.  The  TSO  option  Is  facilitated  by  a  special  log-on 
procedure  (?m3T3 0)  and  the  cowand  procedures  (CLIST) . 

e.  The  system  Is  couprised  of  three  uajor  components:  the  Schedule 
Algorithm  Simulation  System  (5AS3) ,  the  Schedule  Activity  hanager  (SAM), 
and  the  Dyuamic  Resources  Examination  and  .'•anageuent  Sysce"  (OPdAhS). 

(1)  SASS— edits  Input,  verifies  data  base  Integrity,  produces  reports, 
simulates  environments,  and  maintains  data  bases. 
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(2)  SAM— control*  and  schadules  job  level  processing. 

(3)  DREAMS — scans  the  job  control  language( JCL) , 

updates  the  run  matrix  resources  (tapes  and  care), 
and  writes  the  JCL  to  the  network  job  spool. 

Mote.  These  components  are  designed  to  function  together  or  with  the  8AS8 
alone,  if  internal  control  of  job  processing  is  not  a  requirement  at  a 
particular  installation.  Subsequent  chapters  of  this  document  will  discuss 
the  properties  of  each  component  and  their  interrelationship. 
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CHAPTER  2 

SCHEDULE  ALGORITHM  SIMULATION  SYSTEM 


2-1.  Concept .  a.  SASS  la  designed  to  provide  an  effective  and  accurate 
method  oil  automatically  scheduling  a  computer  network.  It  will  optimize 
the  work  required  based  upon  the  environment  In  which  the  work  will  be 
perfonsed. 

b.  Due  to  the  aany  variables  that  are  introduced  Into  any  scheduling 
task  (for  exaaple,  volume  of  Input,  type  of  Input,  resource  availability, 
condition  of  each  waster  file,  and  so  forth),  a  niniaua,  or  nonexistent, 
level  of  predictability  relative  to  any  given  job  way  prevail.  Hence  SASS 
does  not  balance  the  workload  based  on  the  average  running  times  of  the 
jobs  being  scheduled.  Instead  It  optimises  those  jobs  under  Its  control 
based  upon  the  maximum  use  of  the  system  resources  available  (that  is, 
core,  disks,  tapes,  printers,  punches,  and  initiators).  This  concept 
readily  adapts  to  any  dynamic  environment.  This  even  becomes  more 
meaningful  as  the  number  of  jobs  to  be  scheduled  increases  and  as  the  job 
relationships  become  more  complex. 

c.  SASS  Is  the  front  end  of  the  MMS.  For  the  SAM  portion  to  be  used, 
processing  must  first  occur  in  SASS,  which  is  the  only  means  of  accessing 
or  updating  the  master  data  base.  SASS  trill  then,  based  upon  the  user's 
request,  create  or  modify  the  run  matrix,  so  that  SAM  can  dynamically 
schedule  the  execution  of  each  computer  system. 

2-2.  SASS  functions.  The  functions  unique  to  the  SASS  portion  of  MMS  are: 

a.  Master  data  base  format. 

b.  Master  data  base  update. 

c.  Simulation. 

d.  Schedule  initialization. 

e.  Master  data  base  reports. 

f.  Management  reports. 

g.  On-the-fly  updating. 

*2-3.  Master  data  base.  The  master  data  base  is  the  data  set  that  SASS 
uses  In  performing  Its  various  functions.  It  is  comprised  of  two  files, 
the  job  file  and  network  file.  The  MMS  files  are  documented  in  appendix  L. 

*  a.  Job  file.  This  file  contains  all  jobs  that  the  user  would  want 
under  the  control  of  the  MMS.  Each  job  entry  in  this  file  contains  all 
information  for  that  job  that  is  required  by  the  system  to  perform  its 
scheduling  or  controlling  function.  Figure  A-l  depicts  the  elements 
comprising  a  job  entry  in  this  file.  A  definition  of  each  element  follows: 

(1)  Job  number — the  relative  position  of  a  job  within  the  job  file 
(maximum  of  5760). 
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(2)  Job  nano—  the  naae  of  Che  job  undar  MMS  control. 

*  (3)  Voluae  nuaber — the  application  voluae  number  of  which  this  jcb  is  a 

part.  This  eleaent  offers  a  aethod  of  grouping  related  jobs  for  scheduling 
purposes.  The  voluae  nuaber  can  be  froa  1  through  3400. 

(4)  Dependent  job  nuabers — the  data  or  functional  constraints  (maximum  of 
12)  placed  upon  a  job  that  aust  be  aet  prior  to  that  job  being  executed.  MMS 
offers  two  different  types  of  dependency  relationships  that  can  be  indicated. 
One  is  a  dependency  back-off  relationship,  and  the  other  Is  a  no-back-off 
relationship. 

(a)  Back-off  relationship.  If,  in  the  following  job  matrix  segment 

example,  only  jobs  A  and  C  were  to  be  scheduled,  the  resultant  dependency 

relationship  would  appear  as  shown  in  the  resultant  job  aatrlx.  Since  job  C's 
dependency  was  job  B,  and  lob  B  was  not  scheduled,  then  job  C  would  back-off 

Its  dependency  toward  a  job  that  was  In  this  »«ae  string  and  was  scheduled, 

which  in  this  exaaple  was  job  A. 

Example: 

Job  aatrlx  segment  Resultant  job  matrix 

Job  Dependency  Job  Dependency 

A  None  A  None 

BA  C  A 

C  B 

(b)  No  back-off  relationship.  If,  in  the  following  job  aatrlx  segment 

example,  only  jobs  A  and  C  were  to  be  scheduled,  the  resultant  dependency 

relationship  would  appear  as  shown  in  the  resultant  job  aatrlx.  Note  the 
asterisks  surrounding  job  C's  dependency.  The  asterisk  indicates  the 
no-back-off  relationship.  In  this  exaaple,  since  job  B  was  not  scheduled  and 
job  C's  dependency  of  Job  B  indicates  no-back-off,  the  dependency  of  job  C  on 
the  resultant  matrix  becomes  NONE. 

Exaaple: 

Job  aatrlx  segment 

Job  Dependency 

A  None 

B  A 

C  *B* 

(5)  Region — the  region  that  the  job  will  request. 

*  (6)  Piles  used-— the  files  (maximum  of  12)  that  the  job  uses  and  the  aodes 

(R«ceference,  U-update,  S-share,  E-excluslve)  in  which  they  are  used. 


Resultant  job  aatrlx 
Job  Dependency 

A  None 

C  None 
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(7)  Tape  9 — Che  number  of  9-crack  cape  devices  Che  job  uses. 

!  (8)  Tape  — che  nueber  of  7-crack  Cape  devices  Che  job  uses. 

I 

(9)  'r  pe  D— -the  number  of  dual  density  Cape  devices  Che  job  uses. 

(10)  Tape  6 — Che  number  of  6250  BP1  tape  devices  Che  job  uses. 

(11)  Print —the  number  of  prlnCers  Che  job  direct ly  allocates. 

(12)  Punch — che  number  of  punches  Che  job  directly  allocates. 

(13)  Identify— classified  or  privacy  job. 

(14)  Recent  run  dace — Che  Julian  date  of  Che  mosc  recent  running  of  this 
job  (automatically  posted). 

(15)  RecenC  run  time— the  doe  In  minutes  Chat  Che  most  recent  running  of 
chis  job  required  (automatically  posted). 

(16)  Average  run  time— the  time  In  minutes  of  the  current  average  run  time 
of  this  job  (automatically  updated). 

*  \ 

(17)  Times  run— the  number  of  times  that  this  job  has  been  run  since  the 
Installation  of  MMS  (automatically  updated). 

(18)  Priority — Indicates  whether  or  not  this  job  Is  deemed  relatively  more 
critical  than  ocher  jobs  In  the  job  matrix  segment.  It  designates  the  job’s 

l  relative  priority  for  scheduling  purposes;  It  must  be  two  numeric  digits  from 
15  through  01  (default  for  ADO  Is  02). 

(19)  Simulation  flag — Indicates  whether  or  not  a  job  is  to  be  scheduled 
for  simulation  (used  for  internal  processing  only). 

(20)  Identify  machine( a)— indicates  whether  or  not  a  job  can  process  on  a 
machine. 

«  (21)  Early  start  time— the  time  when  this  job  is  to  be  first  considered 

for  scheduling  (from  0001  through  2400). 

b.  Network  file.  The  network  file  is  comprised  of  six  distinct  segments. 
A  definition  of  each  segment  follows: 

*  (1)  Application  segment.  This  segment  contains  the  application  mnemonics 
for  each  of  the  application  volume  numbers  that  the  user  has  established. 
This  segment  offers  the  capability  of  grouping  related  jobs  for  scheduling 
purposes.  The  application  volumes  are  cross-referenced  to  the  application 
mnemonics  and  vice  versa.  Plgures  A-2  and  A- 3  reflect  this  double 
cross-reference.  The  application  volume  numbers  must  be  from  1  to  999. 

*  (2)  Device  segment.  Tnls  segment  contains  tables  of  devices  (that  is, 
disks,  tapes,  printers,  and  punches)  that  Che  user  defines  to  MMS  for 
simulation  purposes  only.  These  cables  are  not  used  by  SAM;  SAM  actually 
scans  the  computer  system  to  make  a  point  -ln-time  determination  of  what 
resources  are  available  and  has  no  need  to  interrogate:  nese  tables.  Figure 
A-6  depicts  the  device  table  and  its  elements. 
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*  (3)  File  segment.  This  segment  contains  the  file  mnemonics  (and  file 
types)  that  the  user  has  established.  There  Is  a  double  cross-reference  from 
file  nuaber  to  file  mnemonic  and  vice  versa.  Figures  A-4  and  A-5  reflect  this 
double  cross-reference.  The  file  numbers  must  be  from  1  to  255. 


(4)  Installation  segment.  This  segment  contains  the  8-byte  installation 
mnemonic  assigned  by  the  user  and  is  displayed  on  all  SASS  reports. 

*  (5)  Machine  network  segment.  This  segaent  contains  the  machine 

Identification  (ID),  time  available,  and  tape  usage  for  each  CPU  defined  to 
MMS. 

*  (6)  File  control  segment.  This  segment  contains  the  time,  date,  and  CFO 

ID  of  last  update  to  the  master  data  base. 

2-4.  Execution  by  function,  a.  General  The  execution  of  tho  various  func¬ 
tions  under  SASS  is  done  by  cataloged  procedures  (PROCs)  as  shown  in  appendix 
B  and  command  procedures  (CLISTs)  as  shown  in  appendix  C.  Each  function  has 
one  or  more  associated  PROCs  and  may  have  an  associated  CLIST.  The  symbolic 
parameters,  as  depicted  in  appendixes  B  and  C,  are  assigned  the  default  values 
to  be  used  in  the  production  environment,  therefore,  need  not  be  repeated  in 
the  execution  PROCs  or  CLISTs.  the  only  symbolic  parameters  required  at 

execution  time  are  chose  mentioned  in  the  narrative  on  function  definition. 

b.  Input  data  set.  When  required,  the.  input  control  data  set  for  SASS 
PROC  and  CLISTs  will  contain  one  or  two  types  of  statements: 

(1)  Control  card  (statement).  This  statement  defines  the  operation  being 
performed  and  the  master  data  base  segment  addressed  (or  the  type  report 
requested).  The  operation  and  operand  must  be  on  the  same  card  (statement). 
The  format  is  as  follows: 

cc  1-3  Operation  Operand 

./b  operation  operand 

Note.  Past  column  3,  free  form  coding  prevails. 

(2)  Data  card  (statement).  This  statement!*)  la  optionally  present  based 
upon  Che  operation  field  of  the  control  card.  It  defines  the  input  to  SaSS  to 
perform  data  base  creation,  aalntenance,  or  simulation.  Ail  data  on  this 
statement  are  free  form,  keyword  coding  with  the  exception  or  data  continuing 
(relative  to  one  action  of  the  operation)  on  to  aore  chan  one  card.  The 
continuation  rules  are  as  follows: 

(a)  A  comma  must  be  inserted  after  the  list  keyword  combination  on  a 

card. 
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(b)  One  or  more  blanks  ere  required  prior  Co  coluan  72. 

(c)  Continuation  of  data  on  subsequent  cards  oust  begin  after  coluan  1. 

c.  Punction  definition.  The  definition  and  performing  characteristics  of 
each  function  and  the  execution  JCL  required  *re  as  follows: 

*  (1)  Master  data  base  forest.  This  function  creates  and  formats  the 
aaster  data  base  for  subsequent  update  processing  and  is  used  for  the  initial 
Installation  of  the  MMS  only. 

(a)  PROC  execution. 

//stepnaae  EXEC  SASSFMTP  .MMATRIX-XXXXXXXX.NEWVOL-YYTYYY 

(b)  CLIST  execution. 

*  SASSFMT 

(2)  Master  data  base  update.  This  function  updates  segments  within  the 
aaster  data  base  either  temporarily  or  permanently.  The  execution  of  this 
function  will  generate  a  report  of  each  of  the  segments  updated  indicating 
whether  the  change  was  temporary  or  permanent. 

(a)  Master  data  base  update. 

Execution  JCL. 

//stepname  EXEC  SASSUPDP 

(b)  Input  control  data  set.  The  input  data  set  is  as  follows: 

1  Control  card. 


cc  1-3 


Operation 


Operand 


./  b 


PMOD 

TMOD 


* 


MATRIX 

APPL 

FILES 

DEVICES 

ENV 

NETWORK 


Note.  Permanent  modif ica.tions  (PMODs)  and  temporary  modifications  (TMODs)  are 
mutually  exclusive  operations.  Only  one  type  of  operation  may  be  performed 
for  each  SA5S  execution.  However,  each  execution  may  address  more  than  one  of 
the  segments  (operands)  of  the  data  base  using  the  same  type  operation. 
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2.  Data  cards.  The  data  cards  must  immediately  follow  the  PMOD  c*  THOu 
control  card  for  the  segment  of  the  master  data  base  being  addressed  by  the 
operand.  Pree  form  keyword  coding  may  begin  in  any  column  prior  to  72 
Continuation  rules  are  followed  (para  2-4b( 2)). ..  Keywords  must  be  separated  by 
a  comma.  Keywords  are  separated  into  thre'.  categories:  required  for  all 
operands,  required  for  specific  master  data  base  segments,  and  optional  for 
specific  segments. 


£  Required  keyword  for  all  operands.  This  keyword  is  required  to  define 
the  type  of  update  to  be  performed. 


Keyword  Pleld  content  Description 


ACTION-  ADD 

AC 


A  new  entry,  one  that  does  not  presently 
exist,  is  La  be  uddsd  to  the  specific 
segment  Identified  by  the  control  card 
operand;  it  cannot  add  fields  to  an 
existing  entry. 


CHANGE  Pleld(s)  are  to  be  altered  in  an 

existing  entry  of  the  specific  segment 
identified  by  the  control  card  operand. 

DELETE  An  existing  entry  is  to  be  deleted  from 

the  specific  segment  identified  by  the 
control  card  operand. 


Jb  Required  keywords  for  specific  segments.  These  keywords  are  required 
to  obtain  entry  into  the  designated  segment. 


Segment 

Keyword 

Description 

*  Job 
matrix 

JOWUM  - 
JN 

The  relative  number  of  the  job  within 
this  segment ,  it  must  be  one  to  fou: 
numeric  digits  from  1  through  5670. 

*  Application 

APPLNO  - 

AN 

The  application  volume  number;  it  must  be 
four  numeric  digits  from  1  through  3400. 

Piles 

PILENO  - 
PN 

The  file  number  of  the  file  being 
addressed;  it  must  be  one  t  i  three 
numeric  digits  from  1  through  25). 

Devices 

None 

All  keywords  are  optional. 

Environment 
( Inc ludes 
dummy  UCBs, 
core,  and 
installation 
segments) 

None 

All  keywords  are  optional. 
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c  Optional  keywords  for  specific  segments.  These  keywords  are  to  be  used 
at  the  discretion  of  the  user  to  update  those  fields  requiring  modification. 


Segment 


Keyword 


Description 


Job  JOBNAME  *  The  job  name  of  the  job  being  modified; 

matrix  JM  can  be  up  to  eight  characters;  required 

if  the  ACTION  keyword  specifies  ADD 
since  there  is  no  default  assignment; 
required  if  the  ACTION  keyword  specifies 
DELETE. 


APPLNO  *  The  application  volume  number;  must  be 
AN  four  numeric  digits  from  1  through  3400; 

required  if  the  ACTION  keyword  specifies 
ADD,  since  there  is  no  default 
assignment. 


DEPNO  *  The  job  number(s)  that  places  a  data  and/ 

DP  or  functional  constraint  on  the  job 

being  modified,  each  must  be  one  to  four 
numeric  digits  from  1  through  5760;  must 
be  enclosed  in  parentheses  even  if  only 
one  job  is  a  constraint  or  NONE  is 
specified;  a  maximum  of  12  dependent  job 
numbers  may  be  specified;  if  the  no 
back-off  option  is  used,  the  job  number 
must  be  preceded  by  a  minus  (-)  sign; 
the  dependency  numbers  are  treated  as  an 
AND  condition,  not  as  an  OR  condition, 
therefore,  all  dependent  jobs  must 
complete  prior  to  this  job  being 
scheduled;  default  assignment  for  ADD  is 
NONE. 


CORE  *  The  region  required  to  execute  this  job, 

CR  must  be  one  to  four  numeric  digits; 

default  for  ADD  is  54K. 

The  indicator  designating  the  job's  rela¬ 
tive  priority  for  scheduling  purposes; 
runs  from  the  high  of  15  to  a  one;  and 
must  be  two  numeric  digits  from  15 
through  01,  default  for  ADD  is  02. 

*  FILENO  •  The  file  number(s)  designating  the  files 

FN  used  by  this  job;  each  must  be  one  to 

three  numeric  digits  from  1  through  255 
preceded  by  an  R  (reference),  U 
(update),  E  (exclusive),  or  S  (share); 
must  be  enclosed  in  parentheses  even  if 
only  one  file  is  used  or  NONE  is 
specified;  a  maximum  of  12  file  numbers 
may  be  specified;  default  for  ADD  is 
NONE.  See  note  for  more  information. 


PRIORITY  - 
PR 
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Segment 

Job 

Matrix 


Keyword 

TAPE9  - 
T9 


TAPE7  - 
T7 


TAPED  - 
TD 


TAPE 6 2 30  - 
T6 


PRINT  - 
PT 


PUNCH  - 
PC 

AVETIME  - 
AT 


TIMESRUN  - 
TR 


RECDATE  - 
RD 


RECTIHE  - 
RT 


CLASPVCY  - 
CL 


EARLYST  - 
ES 


Description 


The  number  of  each  type  of  device 
required  for  this  job;  must  be  oac  or 
two  numeric  digits;  default  for  ADD  -  0. 


The  average  running  time  in  minutes  for 
this  job;  must  be  one  to  four  numeric 
digits;  default  for  ADD-0;  automatically 
maintained  when  times  run  is  greater 
than  9,  times  run  is  automatically  reset 
to  one. 

The  number  of  times  the  job  has  been  run; 
must  be  one  to  four  numeric  digits; 
default  for  ADD  if  AVETIME  is  greater 
than  0  is  1;  if  AVETIME  ■  0,  default  - 
0;  automatically  maintained. 

The  last  four-digit  Julian  date  of  the 
the  most  current  run;  automatically 
maintained . 

The  time  in  minutes  of  the  most  current 
running  of  this  job;  must  be  one  to  four 
numeric  digits;  automatically  maintained. 

The  security  or  privacy  classification 
of  the  job. 

N — non,  default  is  A. 

R— privacy. 

S — secret . 

U — confidential. 

V—for  official  use  only. 

The  early  start  -!me  for  a  job  (from 
0001  through  2400)  will  place  an  early 
start  time  constraint  for  that  job. 
This  time  allows  a  23  hour  59  minute 
look-ahead  and  indicates  when  the  job  is 
to  be  first  considered  for  scheduling. 
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Segment  Keyword 

MACHDEP  - 
MD 


*  Applica¬ 
tion 


APPLNAME  * 
AM 


Files  FILENAME  - 

FM 


TYPE  - 
TY 


Description 

The  machine(s)  the  job  must  run  on  must 
be  eight  alphabetic  positions.  If  the 
job  must  run  on  machine  one  or  three, 
enter  (YNYNNNNN);  required  if  the  ACTION 

keyword  specified  ADD,  since  there  is  no 
default  assignment. 

The  application  mnemonic  for  the 
specified  application  number;  must  be 
one  to  seven  characters;  no  default  is 
assigned;  always  required. 

The  file  mnemonic  for  the  specified  file 
number;  must  be  one  to  five  characters; 
required  if  ACTION  is  ADD,  since  there 
is  no  default  assignment;  required  if 
ACTION  is  DELETE. 

The  type  of  file: 

V— VSAM 

M--CCSS  DMR  file 
S — S2K 
0 — other 
Default  is  M 


<*Note.  File  useage  by  MMS  is  defined  as  follows: 

Reference — file  is  only  being  read. 

Update — file  is  being  updated  and  other  users  can  reference  it. 

Exclusive — file  is  being  updated  but  no  other  use  is  allowed. 

Share — used  for  DMR  files  only.  File  is  being  updated  and  the  DMR  access 
routines  control  updating  by  MAJOR  key.  File  being  shared  can  have 
other  share  and/or  reference  users. 


Devices  TAPE9  ■ 

T9 


TAPE 7  - 

T7 

TAPED  - 
TD 

TAPE6250  - 
T6 


The  number  of  each  type  of  device  to  be 
identified  to  SASS  for  simulation 
purposes;  must  be  one  or  two  numeric 
digits;  no  default  assignment  is  made 
at  data  base  creation  time;  ACTION 
keyword  must  specify  CHANGE. 
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Segment 


Environment 


a  Ne  twork 


Keyword 

DISK  - 
DK 

PRINT  - 
PT 

PUNCH  - 
PC 

CORE  * 
CR 


INSTL  « 


NTWRKNO  * 
NN 


MACH ID  - 
MI 


AVSTIME  - 
AS 


AVETIME  « 
AE 


Description 


The  total  available  system  core  in  thou¬ 
sands  (used  for  simulation  only);  must 
be  one  to  four  numeric  digits  from  2  to 
8000;  ACTION  keyword  must  specify  CHANGE. 

The  installation  mnemonic;  must  be  one 
to  eight  characters;  ACTION  keyword  must 
specify  CHANGE. 

The  network  number  for  each  CPU  as  it  is 
defined  to  the  scheduler;  must  be  one 
numeric  digit  with  a  value  of  1  through 
8;  required  keyword;  ACTION  keyword  must 
specify  CHANGE  or  DELETE. 

The  machine  ID  of  the  network  machine 
being  defined;  must  be  the  first  two 
digits  of  the  systems  management  control 
area  (SMCA);  ACTION  keywork  must  specify 
CHANGE. 

The  beginning  start  time  that  this 
machine  will  be  available  to  the 
scheduler  for  batch  processing;  must  be 
four  numeric  digits  representing  HHMM 
(from  0001  through  2359);  the  default  is 
0000  meaning  that  this  machine  will 
always  be  available  for  batch 
processing;  ACTION  keyword  must  specify 
CHANGE. 

The  time  that  this  machine  will  no  longer 
be  available  for  batch  processing,  must 
be  four  numeric  digits  with  same 
criteria  as  available  start  time  above; 
must  be  used  in  conjunction  with 
AVSTIME;  ACTION  keywork  must  specify 
CHANGE. 
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5*a  me nt  Keyword 


Description 


*  TAPEDUSB  -  Define  to  the  scheduler  whether  or  not 

DU  TAPED  can  eleo  be  used  es  a  TAPh9  for 

this  machine;  auat  be  either  Y  or  R; 
default  la  N;  ACTION  keyword  east 
specify  CHANGE. 


*  TAFE6USE  -  Define  to  the  scheduler  whether  or  not 

60  TAPES  can  also  be  used  as  TAPE 9  for  this 

■a chine;  oust  be  either  T  or  I;  default 
la  N;  ACTION  keyword  met  specify  CHANGE. 

*  (3)  Simulation.  The  simulator  portion  of  SASS  can  be  used  to  simulate 
the  processing  of  applications  and/or  Jobs  as  If  those  jobs  were  to  be 
executed  on  a  computer  utilizing  a  aultlprograulng  environment.  The  simulator 
considers  factors  such  as  available  core  and  devices  (disk,  tape,  printers, 
punches),  active  and  Inactive  initiators,  priority,  disk  file  usage,  and  so 
forth.  Jobs  and/or  applications  can  be  scheduled,  any  temporary  or  permanent 
modification  to  the  master  data  base  can  be  made,  and  special  keyword  process** 
lag  can  be  utilized  for  performing  specific  actions.  Messages  are  produced 
Indicating  reasons  why  a  job  could  not  be  released  to  be  used  for  rescheduling 
and  reconfiguring  purposes.  This  function  will  not  produce  a  run  matrix; 
therefore  simulation  and  re-simulation  of  varied  environments  can  be 
accomplished  without  impact. 


(a)  The  execution  of  this  function  will  generate  three  reports: 

1^  Jobs  being  scheduled.  This  report  will  depict  the  jobs  being  scheduled 
(simulated)  and  the  characteristics  of  each  job.  Including  the  dependencies, 
after  processing  by  the  SASS  dependency  optimizer.  Figure  Ar  13  shows  the 
elements  within  this  output  product. 

L  Inter-lntra  application  dependencies.  This  report  breaks  out  the  inter 
and  intra  application  dependencies  by  job  within  an  application  for  just  those 
jobs  being  simulated.  This  la  primarily  for  use  by  scheduling  personnel,  when 
jobs  must  be  scheduled  out  of  their  normal  scheduling  sequence.  Figure  Arl4 
shows  the  elements  within  this  output  product. 
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4  2  Hardcopy  simulation.  This  report  deplete  the  running  of  the  scheduled 

Jobs  In  s  eu  It  lprogr suing  environment .  It  will  Indicate  Idle  t lss.  If 


present 

(elapsed  tl_, 
output  product. 


_  _  tls*. 

Also,  at  the  end  of  the  report,  s  summary  of  the  times  ere  shorn 
sequential  ties.  Idle  time).  Figure  A- 15  shows  this  type  of 


(b)  Execute  the  simulation  function. 


PROC  execution. 

//stepnaue  EXEC  SASSSIMP 

(c)  Input  control  data  set.  The  Input  data  set  Is  as  follows: 

1^  Control  card. 

cc  1-3  Operation  Operand 

«  ./b  RON  b/HHMM 

Note.  A  four-position  tine  representing  HHMIf  nay  be  used  In  the  operand  to 
represent  a  beginning  tiue  for  the  almilatlon  report. 

4  2  Data  cards.  Cards  must  luuediately  follow  the  RUN  control  card.  Free 

fora  coding  aay  begin  In  any  column  prior  to  72.  Continuation  rules  (para 
2-4 b(2))  are  followed.  Keywords  oust  be  separated  by  a  conus.  The  first  555 
jobs  defined  to  the  simulator  will  be  scheduled;  any  others  will  be  eliminated 
frou  the  scheduling  period,  a  corresponding  message  will  be  generated,  and  the 
simulation  will  be  terminated.  Duplicate  keywords  for  APPLNAME  and  JOBMAMS 
are  allowed  and  treated  as  an  add-on  for  the  scheduling  period.  An  asterisk 
(*)  preceding  a  specific  jobnaue  or  application  name  being  defined  to  the 
simulator  will  assign  priority  to  that  job  or  all  the  Jobs  within  the 
specified  application.  A  slash  (/)  followed  by  a  four-digit  time  (from  l##l 
through  24#0),  following  a  Jobnaae  or  application  name  places  an  early  start 
time  constraint  on  that  job  or  all  jobs  within  the  specified  application. 
This  entry  will  override  the  early  start  time  on  any  affected  job.  This  time 
allows  a  23  hour  59  minute  look-ahead  and  Indicates  when  the  particular  job(s) 
Is  to  be  first  considered  for  scheduling.  All  keywords  are  optional  with  the 
exception  that  at  least  one  job  must  be  input  to  the  simulator  for  scheduling 
by  either  the  APPLNAME  or  JOBNAME  keyword. 


Keyword  Description 

APPLNAME*  Each  application  mnemonic  being  defined  to  the  simulator; 

AM  must  match  the  application  mnemonic  defined  in  the  applica¬ 
tion  segment  of  the  master  data  base  (para  2-3b);  must  be 
enclosed  in  parentheses,  even  if  only  one  application  la 
Input . 
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Keyword 

JOBNAME  - 
JM 


I  NIT 
IN 


STRTIME  - 
ST 


INTERVAL  - 
IT 


MESSAGE  - 
MS 


Description 

Each  job  naae  being  defined  to  the  simulator  that  is  nor  in 
a  unique  functional  application,  or  is  the  only  job  of  many 
within  an  application  that  is  to  be  scheduled,  or  is  the 
only  job  within  an  application  already  defined  by  APPLNAME 
to  which  the  user  will  assign  a  priority  or  an  early  start 
tine;  aust  aatch  the  job  naae  as  defined  in  the  job  aatrix 
segment  of  the  oaster  data  base  (para  2- 3a);  aust  be 
enclosed  in  parentheses,  even  if  only  one  job  is  input. 

The  nuaber  of  initiators  defined  to  the  simulator  for  use 
during  this  simulation;  used  only  within  the  simulator;  must 
be  one  numeric  digit  from  1  through  10;  default  assignment 
is  eight  initiators. 

The  tiae  of  day  representing  the  starting  timt  for  the 
simulator  during  this  simulation;  aust  be  one  to  four  digits 
froa  000  through  2400;  default  assignment  is  the  current 
time  of  day. 

The  time  increment  in  minutes  to  be  used  during  the  simula¬ 
tion;  must  be  one  or  two  digits  froa  1  through  60;  default 
assignment  is  three  ainutes. 

A  message  that  will  appear  on  a  SAM  report  in  the  upper  right 
corner;  replaced  each  tiae  a  S AS SR ON,  SASSSIM,  SASSCHK,  or 
SASSFLY  function  is  executed;  can  be  used  for  cycle  identi¬ 
fication;  default  assignment  is  blank. 


*  (4)  Schedule  Initialisation.  SASS  is  used  to  initially  start  up  a 
scheduling  period  by  creating  the  run  matrix  that  supports  those  jobs 
scheduled  for  execution.  This  function  perforas  the  same  tasks  as  the  simu¬ 
lator  (para  2-4c(3))  with  the  additional  tasks  of  creating  the  run  matrix  and 
starting  the  release  of  jobs  to  the  system.  Jobs  that  are  stored  on  the 
EXECUTION  JCL  file  are  autoaatically  copied  to  the  JCL  job  spool. 


(a)  Initiate  the  schedule. 

PROC  execution 
//stepnaae  EXEC  SASSRDNP 

*  (b)  Input  control  data  set.  The  input  data  set  is  as  follows: 

Control  card 

cc  1-3  Operation  Operand 

./b  RUN  b 


(5)  Master  data  base  reports.  SASS  produces  three  types  of  reports  as 
follows : 
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(a)  SASS  standard  reports.  Thia  option  will  print  salactad  (or  all  of 

the)  waster  data  base  segments  and  cross-references  between  segments-  The 
reports  a;  :  depicted  In  figures  A-l  through  A-10. 

_1  PROC  execution. 

//stepaane  SASSRPTP 


Input  control  data  set.  The  Input  data  set  la  as  follows: 
ii  Control  card. 

cc  1-3  Operation  Operand 


./b  REPORT  MATRIX 

APPL 

FILES 

RESOURCES 

*  NETWORK 

ALL 

XMATRIX 

XAPPUOB 

XAPPLDBP 

FILEMODE 


_b  Data  card(s).  No  data  cards  are  permitted  as  Input  to  this  PROC. 

c  Control  card  conventions.  Only  one  operand  way  be  specified  per  report 
control  card.  Multiple  report  control  cards  way  be  Input. 

<1  Report  operand  definitions; 

MATRIX— generates  a  report  of  the  job  matrix  segment  in  job  number 
sequence  (fig  A-l). 

APPL— generates  a  double  cross-reference  of  application  volume  to  applica¬ 
tion  mnemonic  (sample  report  in  fig  A-2),  and  application  mnemonic  to 
application  volume  (fig  A-3);  not  produced  under  TSO. 

FILES — generates  a  double  cross-reference  of  file  number  to  file  mnemonic 
and  file  mnemonic  to  file  number  (figs  A-4  and  A-5). 

RESOURCES — generates  a  report  shoving  the  system  resources  available  for 
slmlatlon  (core  and  devices)  (fig  A-6). 

XMATRIX — generates  a  report  of  the  job  matrix  segment  in  job  name  sequence 
(fig  A-7) . 

XAPPLJOB— generates,  In  application  mnemonics  sequence,  a  cross-reference 
of  all  jobs  within  each  application  (fig  A-8). 

XAPPLDEP— generates,  in  job  within  application  sequence,  a  breakout  of  the 
inter  and  intra  application  job  dependencies  (fig  A-9). 
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FILEMODE —generates,  in  file  mnemonic  sequence,  a  report  of  all  jobs  using 
that  file  and  a  breakout  of  the  node  used  (reference,  update,  share  or  exclu¬ 
sive)  (fig  A-10  (app  A)). 

ALL — generates  all  reports  produced  by  the  above  operands. 

(b)  SA88  cross-reference  reports.  This  program  will  print  master  data 
base  dependency  cross-reference  data  pertaining  to  an  application  name,  niseber 
or  job  name  (fig  A-16  through  A-18  (app  A)).  It  will  also  produce  in  file 
acrostyn  sequence  cross-reference  reports  between  files  and  update 
exclusive-user,  and  users  (fig.  A-19,  app  A). 

PROC  execution 

// stepname  EXEC  SCXREPP ,  FUNKSHN-XX 

Where  'XX'  specifies  the  cross-reference  to  he  produced. 

FUNKS HN-JM  report  in  job  name  sequence  of  job  dependencies  and 

dependent  jobs. 

FUNKSHN-AM  report  in  application  name  sequence  of  job  dependencies  and 
dependent  jobs. 

FUNKS HN-AN  report  in  application  number  sequence  of  job  dependencies  and 

dependent  jobs. 

FUNKS HN-FA  report  in  file  acronym  sequence  between  files  and  update, 

exclusive  use,  and  share  users. 

(c)  SASS  inquiry.  This  program  will  display  master  data  base  informa¬ 
tion  by  application  name(s),  application  number(s),  job  name(s),  or  job 
number(s). 

CLIST  execution. 

Display  SASS  information  for  specified  application  name(s). 

SCAMINQ 

response  ***  ENTER  APPLICATION  NAME(S)  (MAX  of  50)  *+* 
response  ***  WHEN  THROUGH  ENTER  /*  *** 

Display  -HASS  information  for  specified  job  name(s). 

SCJMINQ 

response  ***  ENTER  JOB  NAME(S)  (MAX  of  50)  *** 
response  ***  WHEN  THROUGH  ENTER  /*  +** 

Display  SASS  information  for  specified  job  number(s). 

SCJNUfQ 

response  ***  ENTER  JOB  NUMBER(S)  (MAX  of  50)  *** 
response  ***  WHEN  THROUGH  ENTER  /*  *** 

Display  SASS  information  for  specified  application  voliae  number(s) 

SCAMINQ 

response  ***  ENTER  APPLICATION  VOLUME  NUMBER(S)  (MAX  of  50)  **+ 
response  ***  WHEN  THROOCH  ENTER  I*  *+* 
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(6)  On- Che-fly  update  test.  The  running  aatrix  ie  updated  during 

production  (on-the-fly)  by  first  executing  a  teat  of  the  changes  to  be 

perforaed. 

(a)  Execution  considerations.  All  accepted  input  to  the  SASSSIMP  and 
SASSUPDP  P&OCs  can  be  input  (i.e.,  updates, _ job  adds/deletea  to  the  aaater 
data  base)  with  the  additional  capability  of  job/application  adds/deletes  to 
the  running  aatrix.  The  execution  of  Che  PROC  for  this  function,  SASSCHKP, 
will  generate  a  report  of  the  before  and  after  iaage  of  the  running  aatrix 
(fig.  B-l)  though  no  actual  update  will  have  taken  place. 

(b)  Restrictions.  Only  TMODs  are  allowed  as  input.  Any  prior  dependency 

TMOD  to  a  job  on  the  current  running  aatrix  aust  have  a  TMOD  applied  again. 
TMODs  affecting  any  fields  other  than  dependencies  need  not  be  repeated  as 

SASS  will  recognise  thea.  Any  job  that  was  a  TMOD  ADD  to  the  current  running 

aatrix  need  not  be  repeated  as  SASS  will  recognise  it  as  such  and  accept  all 
fields,  including  the  dependencies. 

(c)  Test  an  on-the-fly  update. 

PROC  execution 

//stepname  EXEC  SASSCHKP 

(d)  Sequence  of  processing. 

_1  Any  job  that  has  started  and  ended  noraally  will  be  posted  to  the 
master  data  base.  Any  job  that  has  previously  ABENDed  will  not  be  posted. 

2  Any  job  that  has  started  and  ended  noraally,  including  any  job  that  has 
previously  ABENDed  but  has  now  coapleted  noraally,  will  be  deleted  froa  the 
running  aatrix. 

2  All  remaining  jobs  on  the  running  aatrix  are  flagged  as  input  for  the 
simulator  and  scheduling  algorithm. 

4  The  input  data  set  (CARDIN)  is  read. 

5_  All  TMODs  are  processed. 

6  All  FLY  DELETES  are  processed. 

1_  All  FLY  ADDs  are  processed. 

8  The  sinulator  is  activated. 

9  No  running  matrix  or  master  data  base  rewrites  (updates)  are  accom¬ 
plished. 

(e)  Input  control  data  set.  The  input  data  set  is  as  follows: 
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_1  Control  card. 

cc  1-3  Operation  Operand 

./b  FLY  ADD 

DELETE 

2  Data  card(s).  Conventions  previously  mentioned  for  the  SASSSIMP  PROC 
(para  2-4c(3)(c)2)  apply  for  this  function.  Applications  and/or  jobs  a ay  be 
deleted  or  added  to  the  running  matrix. 

*  (7)  On-the  fly  update.  Processing,  control  cards,  data  card(s),  and  out¬ 

puts  are  the  same  as  those  for  the  on-the-fly  update  test  (SASSCHKP)  (para 
2-4c(6)),  vith  the  exception  that  this  function  physically  updates  the  running 
matrix  and  the  master  data  base.  Jobs  that  are  added  to  the  running  matrix 
and  are  on  the  execution  JCL  file  vill  be  written  to  the  network  job  spool. 

(a)  Perform  an  on-the-fly  update. 

PROC  execution 

//stepname  EXEC  SASSFLYP 

(b)  Input  control  data  set  (para  2-4c(6)(e)). 

d.  Function  usage  cross-reference.  Many  of  the  SASS  data  base  func¬ 
tions  (referenced  by  their  PROC  names)  can  be  used  together;  however,  there 
are  exceptions.  Some  functions  are  mutually  exclusive.  Table  2-1  illustrates 
what  function's  input  control  data  set  may  be  secondary  input  to  other  func¬ 
tions. 


I 
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Function  Buaber 


Function  P&OC  naan 


( 


1 

2 

3 

4 
3 
6 
7 


S4SSFMFP 
SASSUPOP 
S4SSSIHP 
-  SASSUJ8P 
SASSKPTP 
SASSCHKP 
SASSFLTP 


PRIMARY 

1 

2 

3 

4 

3 

6 

7 

1 

s8 

8 

8 

8 

8 

8 

2 

8 

8 

8 

T 

8 

8 

* 

3 

8 

* 

•  • 

8 

T 

8 

8 

* 

4 

N 

* 

8 

T 

8 

8 

5 

8 

8 

8 

8 

8 

8 

6 

8 

* 

8 

N 

8 

N 

7 

8 

e 

8 

8 

8 

8 

T  —  allowable. 

8  —  not  allowable 
*  —  only  BCD  allowable. 


( 
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2-3.  Special  procaaaing  utllitiae  and  ogtlona.  a.  Co^>ara  utill 
utility  will  allow  the  am  to  Caspar*  any  two  naatar  data  busts.  Tha  output 
will  indicate  only  thoae  changes  encountered  by  tha  utility. 

PKOC  asaeutiou 

//stapnane  K2EC  SCCOtfBP , SASS1-XXXZXXXX, SASS2-YYYTYYYY 

where  nill«»  •  OSH  of  any  naatar  data  baaa. 
vhara  TYTTITIT  -  OSH  of  any  naatar  data  baaa. 

b.  Inf  ini  ta  dapandancr  aat-up.  Thia  option  ia  available  whan  tha  aitu- 
ation  oeeura  in  which  nora  than  12  dapandaneiaa  ara  required  for  ona  job. 
Hota  that  the  dwmj  jobs  ara  net  scheduled,  bat  ara  a  parnanant  entry  in  tha 

naatar  data  baaa. 

(1)  Technique. 

(a)  Establish  dinajr  joba  ia  tha  job  natriz  secant;  enough  to  contain  all 

thoae  dapandaneiaa  raquirad  (ahould  indicata  tha  no-back-off  option)  for  tha 
job  in  question.  ^ _ 

(b)  Craata  dapandaneiaa  for  tha  job  in  quaation  pointing  to  tha  duany 
joba  (ahould  indicata  tha  back-off  option). 

*  (2)  bangle.  In  thia  azanpla,  JOBA  will  aff actively  have  26-dapandant 

joba.  If  any  of  thoaa  26  dependant  joba  ara  aehadulad  in  thia  echeduling  tiaa 
■frano,  JOBA  will  run  only  after  they  coup  lata. 

Job  natriz  aaanant 


j§±gjl9 

Annlication  nuaber 

Dapandaneiaa 

JOBA 

427 

801,802,803 

omtfn 

600 

-10,-11,-12,-13 

-14,-15,-16 

0QMfT2 

600 

-301,-302,-303, 

-304,-305,-401, 

-402,-403,-404, 

DQMKT3 

600 

-511,-512,-513, 

-514,-515,-516, 

-517,-518,-519, 
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c.  Distribution  instructions. 

(1)  Several  of  the  SASSMAT  PROCs  contain  an  IEBGENER  step  which  is  used 
for  the  input  of  distribution  instructions^-  They  ere  SASSCKP,  SCZXKFP, 
SASSFL7P ,  SASSRPTP ,  end  SASSRONP. 

(2)  To  use  this  option,  the  user  wet  override  the  input  dete  definition 
(DD)  statement  to  specify  a  dete  set  conteining  the  user's  distribution 
Instructions.  The  PROCs  default  to  DD  DUlCfY,DCB-ILKSI ZB-8# .  The  seer's  dete 
set  sust  contain  fixed  length  8#  byte  records.  The  stepnaae  to  override  is 
DIST.  The  DDNAMS  to  override  is  SYS0T1. 

2-6.  Coding  exaeple8.  a.  Formatting  a  neater  dete  base  (for  Initial  build). 

//stepnaae  EXEC  SASSFMTP,MMATRIX-MHATRIX,NEWV0L-V0LM1 

b.  Dpdatlng  segments  in  the  naster  data  base. 

//stepnaae  EXEC  SASSUPDP 
./  PMOD  MATRIX 

AC-ADD,  JN-825 ,  JM-NEW JOB, AN-600, 

DP- ( NONE ) , CR- 7 6 ,T9- 4 , MD- ( NYNNNNNN ) 

AC -CHANGE ,JN-10,DP-(-723, 265, 11), T9-4 
AMJELETE ,  JN-1#1 ,  JM-X293 
./  PMOD  APPL 

AC-ADD, AN-600, AM-NEWAPPL.MD-(YNNNNNNN) 

\  AC -CHANGE .AN-524 , AM-CHGAPPL 

AC-DELETE , AN-42  7 , AM-DELAPPL 
./  PMOD  FILES 

AC-ADD, FN-60,FM-FILEX,PK-2,MD-(YNifNNNNN) 

AC -CHANGE ,FN- 3 , PK-14 
AC -DELETE  ,FN-4,FM-MFDEL 
./  PMOD  ENV 
AC -CHANGE ,CR-10 00 

v  ./  PMOD  NETWORK 

AC -CHANGE ,NN-1 ,MI-P I ,DU-Y , 64-Y 


c.  Simile ting  an  environment. 

//stepnaae  EXEC  SASSSIMP 
./  RUN 

AM-(BI LLING , *PAYROLL , ACCTREC  ) , 
JM-(*NEWJOB/1400), 

IN-4, IT- 5, 

ms-testrun 

./  TMOD  MATRIX 

AC-ADD, JN-845 , JM-NEWJOB .AN-600 , 

DP- (-4 , 6 , 725 ) , CR- 60 ,T9-1 ,MD-(YNNNNNNN ) 
AC-CHANGE , JN- 6 , CR-142 

( 
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d.  On-Ch^fly  updating. 

//stepnaae  3XSC  SA5SFLYP 
.  /  FLY  ADD 

Aii- ( *AP?Ll  , APPL2  / 16  HC )  ,  Jh-  (  JOB  1 )  , 
fr-S-FLYTESTl 
.  /  Ti-OC  (IATRIX 

AC- CHANGE ,  JIJ-o 23  ,DP-(14,-15 ,1?3) 
AC-CHA'I  GF. , JN-62  5 ,  F  S-  (U4 ,  S5 , 36  ) 

AC- CHANGE,  J*-3  42, ?>1 
./  FLY  C2LE12 

A«-  (  APPL3  )  , J .i»  (JOE  2  ) 

e.  Initiating  a.  schedule. 

//stepname  KXCC  3.43S3U;;? 

./  RUM 

Ac  -  ( K iiA  fiC  , ITS;  ACT , CATtfANT , 

’VC  ILL) , 

J;*-(*A4C2  ) 

./  pj.OD  iATFIX 

;n>  CHANGE ,  -C4  C  2  ,Ft;«  <  RC  3 ,  afl  4 ,  Rir  ,0C  5 , 
.  U£6,Uft,Uf2) 

f .  Producing  ataadard  reports . 

//stemiane  EXEC  SA5SEPTP 
.  /  REPORT  XttATKIX 
./  REPORT  FILEi'iODE 

Producing  cross-reference  reports. 

*  / /a  t’pnaoie  EXEC  ,FUGK3iI3J-Art 
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SCHEDULE  ACTIVITY  MANAGER 


*3-1.  Concept.  a.  Scheduling  la  designed  to  autoaatically  control  the 
execution  of  scheduled  jobs  in  the  network  for  a  specified  poriod.  This 
control  is  achieved  by  means  of  one  running  satrix  that  defines  all  jobs  to  be 
run,  the  characteristics  of  each  job  (e.g.,  files  used,  devices  required, 
etc.),  and  the  dependencies  or  relationships  of  those  jobs  with  each  other. 
All  of  these  factors  along  with  available  systao  resources  (e.g.,  initiators 
and  devices)  as  they  exist  at  that  point  in  tine  are  evaluated  by  MMS  to 
effect  an  optimum  network  envlronnent. 

L.  The  available  system  resources  are  determined  by  MHS  through  a  scan  of 
a  specific  system  at  each  point  in  time  that  scheduling  occurs.  The  system 
resources  that  are  defined  in  the  master  data  base  are  not  used  by  SAM  as  the 
scan  of  the  computer  system  provides  an  exact  picture  at  that  Instant. 

c.  Everything  to  be  processed  on  a  computer  system  need  not  be  within  the 
iiaster  djta  base  (and  consequently  in  the  running  matrix).  Since  SAh 
recognizes  the  total  resources  in  use  in  each  computer  system,  it  is  aware  of 
any  resources  being  used  by  a  job  not  under  its  control.  SAM  will  continue  to 
optimize  any  jobs  under  lt3  control  and  schedule  these  jobs  accordingly  based 
on  total  resource  use  within  each  syttem. 

ft  3 .  Then  SArl  releases  a  job,  it  is  certain  that  the  job  will  i egir. 
execution,  due  to  the  system  resources  scan.  This  is  relevant  in  eliminating 
stacking  of  jobs  in  the  job  queue.  Job  stacking  would  de-optlmize  anything 
that  SAM  would  have  optimized.  This  no^-stacklng  concept  will  effect  better 
throughput  and  hence,  more  effective  use  of  each  computer  system. 

e.  3 An  will  check  three  areas  for  a  job  if  all  constraints  and  resources 
have  been  Met.  They  are  checked  in  the  following  order:  hold  queue,  network 
job  spool,  and  then  permanent  JCL.  If  the  job  is  not  located  in  one  of  the 
three  areas,  no  further  check  is  made. 

3-2 .  SAk  functions.  There  are  several  functions  unique  to  SAJi  processing 
available  to  tlie  user  to  monitor  and/or  Initiate  action  within  a  system. 
These  functions  include: 

a.  Tun  matrix  stqtus. 

b.  Syscetb  environment  scan. 

c.  Job  restart. 
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*  d.  Inhibit  installation  scheduling. 

*  e.  Restart  installation  scheduling. 

f.  Individual  system  teraination/restart.  ~ 

* 

g.  Simulation  of  current  workload. 

h.  Posting  job  completion. 

1.  System  scan. 

j.  Running  matrix  update. 

k.  Display  jobs  on  job  network  spool. 

l.  Cancel  job(s)  on  job  network  spool. 

*3-3.  Run  matrix,  a.  The  run  aatrlx  is  the  data  set  that  SAM  uses  for 
scheduling  or  controlling  the  network  envlronaent. 

*  b.  The  run  aatrlx  can  be  created  or  modified  by  the  SASS  portion  of  MMS. 
This  forced  interaction  with  SASS  will  ensure  the  integrity  of  the  master  data 
base  and  the  run  aatrlx  and,  hence,  the  total  syatea,  as  SASS  has  the  ability 
to  intercept  possible  error  conditions  prior  to  their  application  to  the  run 
matrix. 

*  c.  The  run  matrix  can  also  be  modified  by  the  SAM  portion  of  MMS.  This 
method  offers  more  flexibility  in  modifying  the  run  matrix;  however,  there  is 
no  Interaction  with  the  SASS.  The  user  accepts  total  responsibility  for  any 
run  matrix  additions,  changes,  or  deletions,  when  using  this  option. 

*3-4.  Run  matrix  segments.  Figure  B-l  depicts  the  segments  in  the  run  matrix 
that  are  used  by  SAM  to  schedule  or  control  the  system.  A  definition  of  each 
segaent  and  its  elements  follows. 

*  a.  Job  segment .  This  segaent  contains  all  jobs  that  are  currently 
scheduled  for  execution  during  a  processing  cycle. 

*  (1)  Run  job  number — the  run  matrix  job  number;  the  relative  position 
within  the  run  matrix  of  a  job  under  MMS  control  (maximum  of  630). 
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(2)  Master  matrix  job  nuaber — the  aaster  data  base  job  nuaber;  corres¬ 
ponds  to  the  relative  position  of  the  job  within  the  wester  date  base. 

(J)  Job  ii4M — tlio  mm  of  the  Job  under  Mt!)  control. 

*  (4)  Priority — indicates  a  job's  relative  scheduling  importance  within  the 
run  matrix  (value  of  (15)  to  (01)). 

(5)  Job  start— flag  indicating  whether  the  job  has  started  (that  is, 
posted  with  an  S). 

(6)  Job  end— flag  indicating  whether  ox  not  a  job  has  ended  (posted  with 
an  E),  has  abnormally  ended  (posted  with  an  A),  or  has  been  flushed  (posted 
with  an  P). 

(7)  Start  date— the  four-position  Julian  date  that  the  job  started. 

(8)  Start  tine  or  early  start  ties — the  tine  of  day  that  the  job  started 
or  the  tine  of  day  that  the  job  nay  be  considered  for  scheduling. 

(9)  End  time — the  tine  of  day  that  the  job  ended  or  abnormally  ended. 

(10)  Early  start  tiae — the  time  the  job  will  first  be  considered  for 
releasing. 

(11)  Elapsed  tiae — the  total  processing  tiae  of  e  job.  Includes  accumu¬ 
lated  tiae  of  a  job  if  it  abnormally  ended,  restarted,  end  anded  (or 
abnormally  ended  again) . 

(12)  Average  tiae — the  average  elapsed  run  tiae  of  the  job. 

(13)  Job  ABEND  counter— the  nuaber  of  tiaes  that  a  job  has  abnormally 
ended. 

(14)  Application  naae— the  application  naae  of  the  job. 

(15)  Application  nuaber — the  application  volume  number  of  the  job. 

(16)  Classification— the  security  or  privacy  classification  of  the  job. 

*  (17)  Dependent  job  numbers— the  data  end/or  functional  constraints  (anxi¬ 
ous  of  12)  of  a  job,  extrapolated  from  the  aaster  data  base,  in  terms  of  the 
run  matrix  job  numbers. 

(18)  Region — the  region  required  to  execute  the  job. 

(19)  Tape  9 — the  nuaber  of  9-track  tape  drives  required  for  the  job. 

(20)  Tape  7 — the  nuaber  of  7-track  tape  drives  required  for  the  job. 

(21)  Tape  D— the  nuaber  of  dual  density  tape  drives  required  for  the  job. 

(22)  Tape  6 — the  nuaber  of  6250  BPI  tape  drives  required  for  the  job. 
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(23)  Print — the  nuaber  of  printers  required  for  the  job. 

(24)  Punch— the  nuaber  of  punch  units  required  for  the  Job. 

*  (25)  Files  used— the  flies  (aaxlaua  of  12)  that  the  job  uses  and  modes 

(R-reference,  U»update,  S-share,  E-exc lusive)  that  are  used. 

(26)  Machine  dependencies— the  aachlnes  job  can  execute  on. 

(27)  Machine  run— aachine  nuaber  job  is  currently  executing  on  or 

completed  on. 


*  b.  File  aegaent .  This  segaent  contains  the  status,  nuaber  of  current 
users,  and  if  the  file  status  is  shared,  and  the  CPU  that  the  file  is  being 
used  on.  There  are  255  file  entries.  The  relative  position  of  the  aaster 
file  entry  in  this  segaent  corresponds  to  the  file  entry  in  the  data  base  file 
segaent  (app  B). 

c.  File  status.  The  file  status  is  the  current  status  of  the  aaster 
file.  The  values  and  corresponding  definitions  are: 


Value 


Definition 


Low-value 

0 

S 

E 

L 


File  Is  not  in  use. 

File  is  updated  by  one  job. 

File  is  shared  by  one  or  aore  jobs. 
File  Is  exclusively  used  by  one  job. 
File  Is  locked  or  unavailable  for  use. 


*  d.  Termination  aegaent.  This  segaent  consists  of  a  one-byte  field  desig¬ 
nating  whether  or  not  the  run  aatrix  is  teraed  (quieced).  Y  denotes  that  the 
run  aatrix  is  teraed;  N  denotes  that  the  run  aatrix  is  active. 
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*  «.  Message  segment .  An  eight-byte  field  that  is  displayed  on  all  run 
matrix  reports.  This  value  Is  set  during  the  execution  of  the  SASSRUM  or 
SASSFLY  function. 

f.  Date  and  time  segment.  The  date  and  ties  that  a  SASSR.UN  or  SASSFLY 
function  was  last  executed. 

g.  Installation  segment.  This  segaent  contains  the  eight -byte  installa¬ 
tion  mnemonic.  This  ailue  la  set  during  the  execution  of  the  SASSKUN  or 
SASSFLY  function. 

*  h.  Network  segaent.  This  segaent  contains  inforaatlon  on  how  the 
aachlnes  are  defined  to  the  scheduling  network.  It  consists  of  machine  ID, 
the  starting  and  ending  tlae  each  aachlne  la  available  to  the  scheduler,  and 
defines  whether  or  not  TAPED  and  TAPE 6  can  be  used  aa  a  TAPS 9.  Up  to  eight 
network  aachlnes  can  be  defined.  The  relative  position  corresponds  to  the 
eight -byte  aachlne  dependency  entry  in  the  file  segment  (app  B). 

3-5.  Execution  by  function,  a.  General.  The  execution  of  the  various  func¬ 
tions  under  SAM  Is  done  by  PROCs  as  shown  In  appendix  D,  and  CLISTs  as  shown 
in  appendix  C.  Each  function  has  one  or  aore  associated  PROCs  and  CLISTs. 
The  symbolic  parameters,  as  depicted  In  appendixes  C  and  D  are  assigned  the 
default  values  to  be  used  in  the  production  environment;  therefore,  need  not 
be  repeated  in  the  execution  PROCs  or  CLISTs.  The  only  symbolic  parameters 
required  at  execution  time  are  those  mentioned  In  the  following  narrative. 

b.  Execution  options. 

(1)  Selected  PROCs  associated  with  SAM  processing  can  be  Initiated  Into 
the  system  In  any  of  three  methods. 

(a)  Through  an  EXEC  card  (for  example,  //  EXBC  procname). 

(b)  Through  the  system  reader  (for  example,  //  S  procname). 

(c)  Through  the  system  console  (for  example,  S  procname). 

(2)  Each  CLIST  associated  with  SAM  processing  Is  Initiated  through  the 
terminal  (for  example,  clistname)  using  TSO . 

c.  Function  definition.  Each  of  the  functions  under  SAM,  the  definition 
and  performing  characteristics  of  each  function,  and  the  JCL  required  to  exe¬ 
cute  each  function  are: 

*  (1>  Uun  aatrlx  status.  This  function  obtains  current  status  of  the  run 
matrix;  It  can  be  run  at  any  point  In  time  and  does  not  modify  either  data 
base.  (Fig  B-l,  illustrates  this  output  report.) 

*  (a)  Display  status  of  total  run  aatrlx. 

PROC  EXECUTION 
//STEPNAME  EXEC  SAMRPTP 


CUST  EXECUTION 

SAMRPTA 

SAMRPTAH 
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*  (b)  Display  status  of  total  run  aatrlx  in  lob  naae  sequence. 

PROC  EXECUTION 

//STEPNAME  EXEC  SAMRPTP .PUNKSHN-ftPTJBA 

CLIST  EXECUTION 

SAMRPTJ 

SAMRPTJH 

(c)  Display  status  of  only  those  jobs  that  have  not  been  successfully 
coaplated. 

PROC  EXECUTION 

//STEPNAME  EXEC  SAMRPTP ,FUNKSHN«RPTINC 

CLIST  EXECUTION 

SAMRPTI 

SAMIPTIH 

(d)  Display  status  of  only  those  jobs  that  have  not  been  successfully 
coapleted  in  job  name  sequence. 

PROC  EXECUTION 

//STEPNAME  EXEC  SAMRPTP .FUNKSHN-RPTJBI 

CLIST  EXECUTION 

SAMRPTK 

SAM1PTKH 


(e)  Display  status  of  only  those  jobs  that  have  start  and  ABEND  flags. 

CLIST  EXECUTION 
SAMRPTR 

To  selacC  a  SAM  report  by  aystea(s),  add  paraaeter  SYS-XXX  or  STS(XXX)  to  the 
execution.  XXX  represents  froa  one  to  three  processors  to  be  displayed. 
Default  is  all. 

Note.  Output  is  directed  to  hardcopy. 
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(2)  System  environment  scan.  This  function  obtains  the  current  status  of 
the  syscee  environment  as  it  pertains  to  _core,  disks,  tapes,  printers, 
punches,  and  initiators;  it  can  be  run  at  any  point  in  time  ant*  does  not 
modify  either  data  base.  (Fig  B-2  illustrates  this  output  report.) 


■plOC  EXECUTION 

//3T EXEC  SArSdVP 

CE1ST  EXECUTION 

$  i^V 

(3)  Job  restart.  Thi6  function  is  used  to  restart  a  job  that  previously 
has  abnormally  terminated.  It  clears  out  the  job  start  and  end  flags  and  the 
start  date,  start  time,  and  stop  time  fields;  eliminates  job  flush  postings 
(F)  for  jobs  dependent  on  the  abnormally  ended  job;  removes  file  lock(s)  if 
the  abnormally  ended  job  used  flle(s)  in  update,  exclusive  use,  or  share  mode; 
and  initiates  a  scan  of  the  running  matrix  to  determine  optimum  jo'o(s)  to 
release  to  the  system. 

pnoc  execution 

//STLfI’Ai-2  EXEC  SAuhESTP, JN-XXXX 

CL  1ST  EXECUTION 
SAIxaEST  JN(XXXX) 

Where  XXXX  *  the  master  matrix  job  nuober  (from  one  to  four  nuneric  digits)  of 
the  job  to  be  restarted. 

*  Job  6tart.  This  function  is  used  to  start  only  the  job  specified. 

It  will  also  start  a  job  that  has  abnormally  ended  and  will  function  similar 
to  a  restart  except  that  no  scan  la  initiated  to  release  more  jobs.  A  job 
start  can  be  accomplished  even  if  the  system  is  quiesced. 

(5)  System  termination.  This  function  is  used  to  quiesce  the  system.  It 
inhibits  the  releasing  of  jobs  under  KhS  control,  must  be  used  if  KfS  is 
active,  and  the  system  can  be  reinitiated  only  by  SAi'jRUN  function.  To  quiesce 
a  selected  processor,  use  5AAUPD  data  entry  Kri. 

Pl'OC  EXECUTION 
//STZPKAhE  EXEC  SAMTEIU? 

//  S  SA-TERKP 

CLIST  EXEUCTION 
SAhTE^iJ 

(6)  Systa  restart.  This  function  is  used  to  re-initiate  scheduling  fol¬ 
lowing  the  execution  of  the  SAMTERM  function  and  will  remove  the  job  release 
inhibitor  and  initiate  a  scan  of  the  running  matrix. 

PFOC  EXECUTION 
//STEP NAME  EXEC  SAMRCNP 
//  S  SAFRUNT 

CLIST  EXECUTION 
SAMP.UN 
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(7)  Posting  statistics.  This  function  forces  statistics  postings  frc. 
the  running  matrix  to  the  master  data  base  for  any  job  that  has  gone  through  a 
non  al  completion,  posts  date  and  tiie,  re-cwrputes  new  average  tice,  a  ad 
Maintains  the  amber  of  tlaes  a  job  ran.  New  statistics  will  be  available  on 
any  subsequent  S ASS  batter  data  base  report  (including  the  percent  of  tire 
variance  of  this  run  as  compared  to  the  preceding,  average  time).  If  a  job  had 
previously  abnormally  ended  (but  4s  EOJ  no*')  or  nuf  initiated  outside  of  SA£S, 
an  exception  nessage  is  generated,  but  no  statistics  are  poster!. 

7I0C  EXECUTION 
//STFPMAiJ:  3Ai-?03T? 


CL  1ST  EXECUTION 

SAsPQBI 

(!’)  Fi.iulatlon  of  current  workload.  This  function  creates  a  simulation 
of  currently  running  jobs  and  any  subsequent  jobs  to  be  processed  in  the 
scheduling  period  as  defined  on  tha  running  matrix.  (Fig  A-25  illustrates 
this  output  report.) 

?'.0C  EXECUTION 

//iTEPNAi'£  dXEC  SAKSI*? 

(5)  Posting  job  completion.  Tide  function  posts  whether  the  job  has 
en!ud  normally  (i  .e. ,  E)  or  abnormally  (i .e. ,  A).  A  job  is  considered  to  have 
enuec  normally  if  the  system  completion  code  equals  uro  and  the  user 
completion  code  is  less  than  5 CC,  If  the  job  is  terminating  abnormally,  any 
dependant  job  is  posted  with  a  flush  (i.e.,  F)  indicating  that  it  ie  not 
releasable  by  3A>.  until  the  abnormally  endec  job  is  restarted  and  completes 
normally,  and  if  any  files  were  used  in  update,  share,  or  exclusive-use  node, 
a  loch  is  placed  on  that  file.  After  the  posting,  occurs,  SAC  initiates  a  scau 
of  the  running  matrix  to  determine  optimum  job(s)  to  release  to  the  6ystex. 

Note.  The  PPOC  execution  step  oust  be  placed  as  the  last  Jobstep  in  the  jot. 

(a)  Post  enc  to  jot. 

?:«oc  Exscunoh 

//CTEFNAifi  £X?.C  SAt.dt’v? 

C.IST  EXCCITflOK 
J ) 

(b)  Post  A5TKD  to  job. 

FP.OC  EXECUTION 

//STEPNAhE  EXFC  SAliA>SDP,JN-JOLKA(f. 

a  1ST  EiCICUT  IOh 

SA-AiEND  Jb(XXXX) 

(c)  Fost  end  to  batch  job  other  than  batch  jcb  that  is  executing  step. 

PROC  zzicvr ION 

//oTEPNA:\Z  EXEC  SAI-iENTh,  ;;OLE-T, JN-JJC::: 
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?ROC  «XHCUClOQ 

//stepnaaa  ZXEC  SAHEMJP, J03NUtt>«x 
//•Cap um  EXEC  SAeEIiUP 


Where  m  •  Tha  us  car  aatrix  job  noaber  of  eba  job  ending.  If  JOBSDH  is  noc 
specified,  3  AH  will  os  a  eba  jobnaae  to  dynamically  dataralna  eba  eorraet  job 
oiubar. 


CL  1ST  execution 
SAritfU  J08WW(«x) 

SAH2KD  J<BHUtj(x*x)  FUNKS  HN(  ABEND  ) 

Where  m  •  Tha  us  car  Jatrix  job  ouabar  of  tha  job  ending.  The  dafanlt  value 
of  fuxxjhs  la  sxu. 

(1C)  Syetea  scan.  This  function  lnldatas  a  scan  of  tha  running  aatrix 
Co  dataralna  optlauc  job  (a)  Co  ba  ralaasad.  If  tha  running  naerlx  la  earned 
whan  Chi  a  function  la  executed,  than  eboaa  jobs  that  are  available  for  ralaata 
arc  displayed,  byt  no  action  la  takaa. 


rBGC  EXECUTION 
//3TE?NAH£  ZXEC  SAISCANP 

cl  is?  escoixor 

SAKS  CAI2 

•  % 

(11)  tunning  Matrix  update.  TUI  a  function  updates  the  naming  aatrlx 
without  Interaction  with  tha  aaetar  data  base.  Tha  user  auat  verify  the 
resulting  naming  uatrlx  entries,  and  only  data  cards  are  required. 

P*3C  EXECUTION 
//STEPNAiff  ZXEC  SAfcDPDP 
DATA  CAADS 

a  1ST  EXECUTION 
SAKUPD 

22SP0NSZ:  SNTEA  TRANSACTIONS  SESIKZU 
WHEN  TH20UGH  ESTES  /* 

CONTINUATION  LISES  HOST  BE 
EKIZ2ED  WITH  A  BLANK  IN  CGLUtff  1 


( 

\ 


3-9 


C5,  Vol.  15,  CCSSOI  18-320 
Data  entries  are  as  follows: 


(a)  Required  keywords  are  as  follows: 

Keyword  Explanation 

*  JN-XXX  Specifies  the  run  aatri;f  job  nuaber  that  is  fro*  one  to 

three  digits  having  a  value  of  1  through  630. 

*  FS-RESET  Resets  the  status  and  nuaber  of  users  for  all  run  aatrlx 

■aster  files.  It  should  not  be  necessary  to  execute 
this  option  unless  an  error  has  occurred  in  SASS 

processing.  PS  is  outually  exclusive  with  other 
keywords. 

ft  FN- (LYY ,  XYY , FY )  Change  the  status  of  one  or  aore  files  on  the  run  aatrlx 

and  autoaatically  adjust  the  nuaber  of  users  for  each 
file.  Each  file  to  be  changed  oust  be  one  to  three 

nuoerlc  digits  froa  1  to  255  and  preceded  by  an  L 

(lock),  X  (lock  except  for  reference  users,  or  P  (free 

and  initiate  a  scan  to  reset  the  status  according  to  the 
current  users  of  the  file).  FN  used  for  this  purpose  is 
mutually  exclusive  with  other  keywords. 

ft  ND-XXXYY  Change  the  nuaber  of  devices  assigned  to  a 

run  aatrlx  where: 

XXX-file  nuaber  (three  nuaerlc  digits  froa 
255. 

YY-nuaber  of  devices  (two  nuaerlc  digits 
99).  Keyword  ND  is  mutually  exclusive 
keywords. 

(b)  Optional  keywords  to  be  used  with  keyword  JN  are  as  follows: 


file  on  the 

001  through 

froa  01  to 
with  other 


Keyword 

RM-CLEAR 

*  RM-OELETE 

ES-XXXX 


ft  DP- (XXX, XXX) 


JM-XXXXXXXX 


Explanation 

Clears  start  and  end  froa  a  job.  The  job  aust  have 
started  and  ended. 

Deletes  the  job  froa  the  run  aatrlx.  Job  aust  not  have 
started  or  already  started  and  ended. 

Specifies  the  early  start  tiae  in  HHMM  format  that  is  to 
be  the  tiae  that  the  job  is  to  first  be  considered  for 
scheduling  purposes. 

Specifies  run  aatrlx  job  nuabers  that  coastraln  the  job 
being  aodlfled.  Each  aust  be  froa  one  to  three  nuaerlc 
digits  with  a  value  of  1  through  630.  The  DP  value  aust 
be  enclosed  in  parentheses  even  if  one  job  nuaber  or 
NONE,  nuaber  or  NONE  is  specified;  the  aaxiaua  nuaber  of 
dependent  job  nuabers  is  12  and  the  default  for  ADD  is 
NONE. 

Specifies  JOBNAME;  required  keyword  for  ADD. 


) 
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Keyword  Explanation 

# 

CR"***  Specifies  the  region  required  to  execute;  must  be  from 

one  to  four  nuaerlc  digits;  default  for  ADD  Is  54K. 

PR-X  Specifies  the  relative  priority  that  this  job  should 

receive  for  scheduling  purposes.  If  entered,  the  value 
aust  be  15  through  01.  default  for  ADD  is  02. 

DT-YDDD  Specifies  four-digit  Julian  start  date. 

T>“XX  Specifies  the  nuuber  of  each  type  of  device  required 

T7»X  for  the  job;  isust  be  nueeric;  default  for  ADD  Is  sero. 

TD-XX 

T6-XX 

PT-X 

PC-X 


*  FN-(RXX.UXX.SXX)  Specifies  the  file  nuaber(s)  of  theunaater  files  used 

by  the  job.  Each  number  euat  be  one  to  three  numeric 
digits  froa  1  to  255  and  preceded  by  an  R  (reference). 
U  (update).  S  (share),  or  B  (exclusive).  To  remove 
files  froa  the  job's  run  aatrix  entry,  specify 
PN-(NONE).  The  default  for  ADD  Is  HONE. 

*  DN-XXXX  Specifies  the  aaster  aatrix  job  nunber  of  the  job  being 

added  or  changed;  must  be  froa  one  to  four  nuaerlc 
digits  froa  1  through  5760;  required  keyword  for  ADD. 


CL-X  The  security  or  privacy  classification  of  the  job. 

N  ■  none,  default  is  N 
R  •  privacy 
S  -  secret 
U  -  confidential 
V  -  for  official  use  only 


A 


CP-X  To  identify  job  as  critical  path  requires  T,  default 

for  ADD  is  N. 

i 

M  *  Sigh  CPU/non-crltlcal  path 
N  -  Non-critical/low  CPU 
7  -  Critical  path/low  CPU 
X  -  Critical  path/high  CPU 


MDa(XXXXXXXX)  The  aachine(s)  the  job  must  run  on,  oust  be  eight 

alphabetic  positions  (Y  or  N).  If  job  must  run  on 
aachine  one  or  three,  enter  (YNYNNNNN).  Entry  is 
required  if  job  is  ADD. 
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W-(XYYYYZZZZ)  Assign  the  tlmefrane  a  machine  will  be  unavailable  for 
batch  processing.  X-represents  the  machine  mnber, 

TtTi -represent a  the  etarting  time,  and  ZZZZ-represents 
the  ending  time.  EXAMPLE:  HM«(3C72217f3)  machine 

number  three  will  be  unavailable  for  batch  processing 
from  C7df  hours  until  1722  hours.  If  the  average  run 
time  for  a  new  job  is  two  hours  and  a  job  ends  in 
machine  three  at  G515  hours,  the  new  job  cannot  be  run 
in  machine  three  until  after  170G  hours.  This  nay  also 
be  used  to  stop  batch  processing  in  order  to  cycle  the 
rachlns  down.  If  used  to  cycle  machine  down,  be  sure 
and  remove  after  restarting  processing.  If  not  removed, 
the  machine  will  cycle  dc'.:n  again  in  24  hours. 


Aii-(XXXXXXXX)  Application  name. 


(12)  Display  jobs  on  network  spool.  During  the  course  of  a  process 
cycle,  the  control  person  needs  to  know  what  job  or  jobs  are  loaded  on  the 
network  job  spool.  ii  the  control  person  wants  to  check  on  a  specific  job  or 
jobs,  he/she  needs  to  euter  only  those,  or  enter  /*  to  display  all  the  job6  on 
the  network  job  spool. 


?roc  execution 

//STEPNAKi  EXEC  SAftLISPP 


a  LIT  EXECUTION 
S  AMD  ISP 


(13)  Cancel  a  job  from  network  job  spool.  It  may  be  necessary  to  cancel 
a  job  fr or.  the  network  job  spool.  Just  enter  the  job  name(s)  separated  by 
coQma(s),  one  full  line  only. 

PKOC  EXECUTION 
//STSPNAnZ  EXEC  SA-iCANC? 

JObNAfiE  1,  JG5NAil22 ,  JOE  NAlvE  3  ,  J0SNAIE4,  j:>SNAb25 ,  JOSJA^f  ,  JOIKANE7 


/* 

a  1ST  EXE  CUT  ION 
SAM CAN C 

(14)  Post  ABEND  flags  to  all  jobs  processing  on  a  machine  that  is  down. 
X  represents  the  numeric  machine  ninber  that  is  down. 

?r.oc  execution 

/ /STZPNAs'E  EXEC  SAtiDOWiP.SYS-X 

a  1ST  EXECUTION 
SAhDOUN  SYS(X) 
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(15)  Status  of  a  job.  During  a  process  cycle,  the  control  person  needs  to 
know  if  a  job  has  been  loaded.  This  procedure  will  tell  the  control  if  a 
specific  job  Is  on  the  following  hold  queue,  Job  spool,  or  perunent  JCL  file. 

CL  1ST  EXECUTION 
SAK5T 

J03NAHE1  ,J0B?lAkE2  ,J0BNAfiZ3 
/* 

(16)  Activate  a  job  if  resources  ere  available,  even  if  system  is 
quiesced.  This  function  will  perform  the  sane  /unction  as  a  S»Afc  restart 
except  that  only  the  requested  job  aay  be  released  if  resources  are* available. 

CL  1ST  EXE CUT  ION 
3AMSTA3T  JN(XXXX) 

(17)  Display  job  cages  on  the  EXECUTION  JCL  file. 

a  1ST  EXECUTION 

SAi‘JNA.<E5 

(IS)  Delete  a  job  from  the  EXECUTION  JCL  file. 

CL  1ST  EXECUTION 
SAHDEL  cEt  3  ERICAS 

( 19)  List  a  job  on  the  EXECUTION  JCL  file. 

a  1st  rxscurioN 
SADIST  tfiMUEHNAXS 

(2C)  (a)  Copy  a  member  to  EXECUTION  JCL  file  from  another  ?DS. 

a  1ST  EXECUTION 

SAidCOPY  OTKF.KPDSlAhE  (OTHER  PDS  ME r.3 EPUAKE  ) 

(b)  Copy  a  numler  to  PERMNFNT  JCL  from  another  ?1>S. 

CL  1ST  EXECUTION 

SAMPCPY  INHERE  XXX- PDS  YYY-dEM3SR 

(21)  Load  a  job  on  SAt-i  spool  from  the  EXECUTION  JCL.  SAhCOPY  will  copy 
the  meober  in  Its  entirety. 

CL  1ST  EXECUTION 
SAMCSNER  XXXXXXXX 

WHERE  XXXXXXXX- JGS  NAME 

(22)  List  a  job  on  the  Network  Job  Spool. 

CL  1ST  EXECUTION 
SANS POOL  XXXXXXXX 

WHERE  XXXXXXXX  is  the  job  nare  that  is  to  be  listed. 
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(23)  Load  JCL  from  EXECUTION  JCL  to  network  job  spool.  To  be  used  only 
when  FLY/RUN  ABENDS  prior  Co  loading  JCL  and  after  jobs  have  been  added  to  the 
running  matrix. 


//JOB NAME 

JOB 

//SCRC0PY1 

EXEC 

SCRCOPYP 

//SCRC0PY2 

EXEC 

SCRCOPYP, COND-(200,LT) 

/ / SCRCOPY . SYS IN 

DD 

DSN-C. SCRAM. AC70ASB71 

//SCRCOPY.CRDSOUT 

DD 

DSN-C. SCRAM. AC70ASB70 

/ / SCRC0PY3 

/* 

EXEC 

SCRCOPYP, COND-(200,LT) 

Note.  A  back-up  copy  of  the  above  JCL  is  on  the  execution  JCL  file  as  member 
name-SCRCOPY. 

(24)  Temporary  change  to  permanent  JCL  file.  If  for  any  reason  a 
temporary  one-time  change  to  a  job  on  the  permanent  JCL  file  is  desired, 
execute  the  following  procedure: 

CLIST  EXECUTION 
SAMPEDIT  XXXXXXXX 

Where  XXXXXXXX  is  the  job  name  that  is  to  be  changed. 

When  the  CRT  input  lock  goes  off,  edit  and  change  the  job. 

Note.  To  request  resource  requirements  to  be  re-completed,  insert  a. 

//♦DREAMS  SCAN  CARD  IN  FRONT  OF  THE  JOB  CARD. 

SAVE 

END 

DREAMST  XXXXXXXX 

When  the  CRT  returns  to  ready,  the  edited  job  will  be  on  the  job  spool. 

*  (25)  To  format  the  running  matrix. 

CLIST  execution 
SAMFMAT 

3-6.  Operational  considerations.  a.  Required  when  SCRAM  is  active.  There 
are  two  specific  instructions  that  must  be  adhered  to  for  the  efficient  oper¬ 
ation  of  SAM. 

(1)  If  the  computer  system  is  to  be  quiesced,  always  use  the  SAMTERM 
function  of  SAM  as  opposed  to  computer  operator  commands  to  the  computer  sys¬ 
tem.  This  will  prohibit  the  releasing  of  jobs  to  the  system  by  SAM,  thus 
causing  the  system  to  dry  up. 
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(2)  SAM  only  considers  Class  A  initiators  as  available  for  use. 
b.  Special  conditions. 

(1)  Releasing  a  job  in  the  running  matrix  manually.  When  the  SAMEND 
function  for  that  job  is  processed,  the  running  matrix  will  reflect  an  E  with 
no  S  flag  and  a  zero  end  time  and  elapsed  time.  It  will  not  inhibit  releasing 
of  dependent  jobs  and  will  not  be  posted  by  the  SAMPOST  function  to  the  master 
matrix. 
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(2)  Modification  of  normal  completion  codes.  The  SAMJMD  cataloged  pro¬ 
cedure  la  internally  condition  coded,  so  thaf  user  completion  codes  of  greater 
than  499  are  considered  to  be  abnormal.  In  the  event  that  this  requires  modi¬ 
fication,  it  could  be  bandied  in  one  of  two  ways: 

(a)  PROP  modification.  If  all  jobs  within  the  data  base  are  equally 
affected,  the  cataloged  procedure  should  be  modified  accordingly. 

(b)  PftOC  overrides.  If  selected  jobs  are  affected,  the  JCL  required  to 
override  must  be  as  follows: 

//stepname  EXEC  5A'pfiNDP,C0ND.ESD«(xxx. . . ) 

Where  xxx  *  proper  condition  codes  that  reflect  the  event  in  which  the  user 
wants  3AM  to  post  an  ABEND  to  the  running  matrix. 

(3)  Running  matrix  save  and  recovery  procedures.  SASSFLYP'  and  SA3SRUN? 
cataloged  procedures  have  an  additional  step  that  copies  the  old  running 
matrix  to  data  set  C.WSCRAM  before  any  updates  are  made.  To  recover  the  old 
running  matrix  (in  case  of  serious  system  problems)  execute  the  following  JCL: 

/  /X.  AT  EXEC  PGh-IEi’»GENER 

//SYSPRIKT  DD  SYSOUT-A 

//SYSUT1  DD  DSN-C.WSCRArt.DISP-SHR 

//3Y3UT2  DD  DSN-C.RSCRAM.DISP-SHR 

//SYS  IX  DD  DUMMY 


Parameter  values  for  the  SAt-EUD  program. 


(1)  The  SAMSNDn  program  is  executed  by  the  following  PKCCs  (and  CLISTs) 
in  the  3A.-!  portion  of  the  KMS :  SAfCNDP  (SAMEfiD) ,  SAtEKVP  (SAbENV),  SAMRE3TP 
(SAHTxSST)  ,  SAwRUNP  (SAMKUN)  ,  3AMSCA»  (SAi'iSCAN)  ,  and  SAMTZRfc?  ( SAMIS Rh ) . 
There  are  seven  parameters  input  to  SAiCND.  Their  definition,  symbolic  name 
to  override,  if  present,  and  pentissehle  values  are  described  below. 


Definition 
Operating  mode 


Symbolic 


Hardcoded 


Permissable  values 

B — batch  mode. 

T— terminal  mode. 


Action  to  be  performed  Hardcoded  E-post  normal  job  termination. 

A— post  abnormal  job  termination. 
I— obtain  system  resources. 
RESTART— restart  an  abnormally 
ended  job. 

remove  the  term  from  running 
matrix  and  scan  for  jobs  to 
release . 

D— post  ABEND  to  all  jobs  on  a 
specific  machine. 
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Permissahle  values 


N — scan  running  matrix  for  joLs  to 
release. 

T— flag  the"-  running  matrix  to  prevent 
the  releasing  of  jobs. 


Master  matrix  job  number  to  be 
processed.  It  pertains  to  restarting 
jobs;  if  the  FEOC  executed  is  part  of 
the  job  being  processed  by  5.U3VU,  then 
this  parareter  is  not  required  because 
5AHEUD  will  use  the  JGBNAhZ  to  determine 
the  JOBNUh. 

(2)  The  hardcoded  values  and  symbolic  defaults  for  each  CLIST  and  PROC 
are  described  below. 


Faraneter 

CLIST/PROC 

Symbolic  default 

Hardcoded  value 

Operating  mode 

All  CLISTs  (except 
thosa  ending  in  t) 

T 

All  ?ROCs  (and 

CLISTs  ending  in  H) 

- 

3 

Action  to  be 

S AMEND 

FUNKS KN( END) 

performed 

SAH2NUP 

r 

END  or  ABEND 

(Depending  on 
condition  code.) 

SAMSXV(P) 

ENV 

SA*REST(P) 

RESTART 

JAZriUW(P) 

RUN 

SAi'jSCAN(P) 

SCAN 

SAMTERti(P) 

TERN 

Master  data 

All  CLISTs 

Unknown 

base  DSN 

All  pr.ocs 

Unknown 

Running  matrix 

All  CLISTs 

RWATRIX  ( ALMS  A .  R1ATRIX  ) 

All  PROCs 

?.  MAT  RI X-  AL  IS  A .  R  MAT  ?*I X 

Master  matrix 

SA*ND 

nunber 

SAMR£ST(P) 

JOENU^hONUM 

(Job  nuaber  must 
be  specified  to 
execute  restart.) 


3AMZNDP 


Definition 


Symbolic 


Master  matrix  job  JGENUM 


) 
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*3-7.  Processing  considerations.  MMS  controls  only  the  job  ueing  class  A 
Initiators.  Prior  to  the  execution  of  MMS  in  each  CPU,  one  or  aore  class  A 
initiators  aust  be  started. 
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CHAPTER  4 

DYNAMIC  RESOURCES  EXAM  NAT  I  ON  AND  MANAGEMENT  SYSTEM 


4-1 .  Concept.  DkEAiS  facilitates  the  echedullng  of  the  tfKS  network  by 
providing  three  sources  of  JCL  to  all  processors  within  the  scheduling  network. 

a.  Tne  network  job  spool  contains  jobs  stored  as  sequential  data  sets.  A 
UEEAii5  reader  reads  raw  JCL  and  writes  jobs  on  the  network  job  spool.  SAM 
reads  a  specific  job  from  the  network  job  spool  and  releases  it  to  a 

processor.  SAM  will  delete  the  job  from  the  network  job  spool  after  the  job 
is  released. 

*  b.  The  permanent  JCL  file  (DSN*C.ALriSA.MhS.SAEJCL  and  DDKAhE  -  SAM  JCL) 
Is  a  partition  data  set  containing  jobs  that  do  not  require  JCL  nodi  fication 
(e.g.  parameters,  hardcoded  volume  serials,  etc.). 

«  c.  The  execution  JCL  file  (DSN*AL^A.MMS.SX2CJCL  and  DDNAKE*3CRMJCL)  is  a 
partition  data  set  containing  jobs  that  require  JCL  modification  (e.g. 
parameters,  hardcoded  volume  serials,  etc.).  This  file  is  accessed  only 

during  the  execution  of  a  5ASSFLY  or  5AMEDIT.  Once  a  job  has  been  selected 

for  processing,  it  is  written  to  the  network  job  spool  for  initiation  es 
determined  by  3A.:.  S  AZ  releases  jobs  for  execution  from  one  of  three 

facilities.  The  facilities  are  searched  in  the  following  order: 

*  (1)  The  OS/.’VT  or  OS/MVS  hold  queue  on  the  specific  processor  the  job  is 
executed  on. 

2)  Tne  network  jcb  spool,  which  is  available  to  all  processors  in  the  Mt<3 
network. 


(3)  The  permanent  JCL  file,  which  is  available  to  all  processors  in  the 
{»:?£»  network. 

Note.  If  the  job  is  not  found  on  any  of  the  three  facilities,  the  job  will 
not  be  released. 

4-2.  DREADS  functions,  a.  The  standard  functions  unique  to  DREAMS  are  to: 

(1)  Build  the  network  job  spool. 

(2)  Build  the  execution  JCL  file. 

(3)  Eliminate  Typer ua-Hold  . 

b.  The  optional,  functions  unique  to  DKEAciS  are  to: 

(1)  Update  the  master  data  base  with  correct  resources. 

(2)  Upaate  running  matrix  with  correct  resources. 

(3)  Edit  accounting. 

(4)  Change  JOBCASC  class  to  A. 
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4-3.  Execution  by  function,  a.  General .  The  execution  of  various  functions 
of  DREAMS  provides  flexibility  of  jobstream  control  in  the  production 
environaent.  The  execution  of  tne  function  under  DREAMS  is  done  by  PROCs  and 

'CLISTs  as  shown  in  appendixes  C  and  D.  Each  function  has  one  or  Bore 
associated  PROCs  and  CLISTs. 

b.  Execution  options. 

(1)  Selected  PROCs  associated  with  DREAMS  processing  can  be  initated 
into  the  system  by  three  methods: 

(a)  Through  an  EXEC  card  (e.g.,  //EXEC  PROCNAME). 

(b)  Through  the  system  reader  (e.g.,  //  S  PROCNAME). 

(c)  Through  the  system  console  (e.g.,  S  PROCNAME). 

(2)  Each  CLIST  associated  with  DREAMS  is  initiated  through  the  terminal 
(e.g.,  CLISTNAME)  using  TSO. 

c.  Punction  definition.  The  definition  and  performing  characteristics 
of  each  DREAMS  function,  and  the  JCL  required,  are: 

(1)  Update  the  network  job  spool.  This  function  reads  raw  JCL  and 
writes  jobs  to  the  network  job  spool.  This  function  require  two  procedures: 

(a)  D REAMS R.  This  procedure  scratches  any  unused  data  set  and  allocates 
50  data  sets  on  the  network  job  spool  pack.  DREAMSR  automatically  starts 
DREAMS. 


(b)  DREAMS.  This  procedure  reads  JCL  and  writes  jobs  to  the  network 
job  spool.  The  maximum  nusfcer  of  jobs  that  can  be  read  in  one  execution  of 
DREAMS  is  50.  If  more  than  50  jobs  are  input  to  DREAMS  in  one  group,  DREAMS 
will  process  50  jobs  then  display  a  message  on  the  system  console  (XXDREAMS 
ENDING).  Prior  to  the  operator  restarting  DREAMSR,  the  reader  must  be  cleared 
and  the  input  card  stack  reset  to  resume  reading  on  the  51st  job  card  (this 
will  be  the  last  card  read).  If  more  than  35  jobs,  but  leas  than  50  jobs  are 
read  in  one  group,  DREAMS  will  process  the  jobs  then  display  a  message  on  the 
system  console.  When  DREAMS  ends,  it  automatically  starts  DREAMSR.  When 
reading  directly  from  the  card  reader,  the  end  of  file  must  be  on.  To  close 
DREAMS,  read  only  one  slash-slash  card  with  the  end  of  file  on  the  card  reader. 

Note.  Reader  unit  default  is  00C,  if  another  reader  is  desired,  add 
READER" XXX  to  the  execute  statement.  If  a  different  media  is  desired,  enter: 

//DREAMS. EAWJCLIN  DD  DESIRED  -  MEDIA  -  DATE 
PROC  EXECUTION 

//STEPNAME  EXEC  DREAMSR 
//  S  DREAMSR 
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*  (c)  Options.  If  requested,  DREAMS  will  update  tha  running  eatrix 

with  current  resource  requirements  (tape  and  core).  To  request  matrix-, 
updates.  Insert  a  //  and  DREAMS  card  In  front  of  the  job  card.  DREAMS  will 
edit  the  accounting  number  to  prevent  any  uanual  correction  of  these 
currently  rejected  errors.  If  this  edit  is  desired,  add  DD  card  AC7ABCC1 
to  the  DREAMS  ROC.  DREAMS  will  change  the  job  class  to  A  In  the  Job 
card.  Using  the  SAMCOPT  procedure  (progrsa  APCAOB)  If  the  first  parameter 
is  specified  as  T  tha  TTPRD*  BOLD  JCL  pa  rase  ter  will  not  be  changed. 
Otherwise  if  I,  the  JCL  is  changed  to  NOTIPT-BOLD  (useful  if  scheduling 
spool  option).  If  the  second  parses tar  is  specified  as  H  the  'CLASS' 
paraaeter  will  reaaln  as  originally  specified.  Default  is  T  which  will 
change  job  card  to  'CLASSES'.  When  executing  prograe  APCASB,  which  loads 
jobs  froa  PDS  to  spool  (usually  done  in  SCRCOFY  step  of  SASSFLYP.SASSIDNP), 
if  the  first  paraaeter  is  specified  as  T  then  NOTIFY-HOLD  is  changed  to 
TYPRDN-aOLD  and  JCL  is  written  to  the  internal  raader.  Othervlae  if  N,  the 
JCL  will  be  loaded  to  spool.  If  the  second  paraaeter  is  specified  as  H,  in 
this  spool  option,  the  CLASS-  paraaeter  will  regain  as  originally 
specified.  Default  is  T  which  will  change  job  card  'CLASS-A' . 

(2)  Update  execution  JCL  file  and  waster  data  base.  Tills 
function  updates  tha  aastar  data  base  with  current  resource  requireaents 
(TAPE  AND  CORE)  and  adds  raw  JCL  to  the  EXECUTION  JCL  file.  For  first  tiae 
jobs,  or  at  release  tiae,  use  4AMC0PT. 

FROC  EXECUTION 

EXECUTE  FROM  PDS 

//STEFNAME  EXEC  DHEAMSP,DSN«»XXXXXX(MMMMM) ' 

(a)  Option.  This  function  updates  the  aaster  data  base  with 
current  resource  requireaents  (TAPES  and  CORE) . 

PROC  EXECUTION 

//STEFNAME  EXEC  DREAMS B ,0 SN- ' XXXXXX(MMMMM) ' 

Note.  The  EXECUTION  JCL  will  have  a  //  and  /*E0F  record  added  at  the  end 
of  each  job.  Updating  the  EXECUTION  JCL  file  through  DREAMS  is  aandatory. 
Do  NOT  use  IEBUPDTE  or  EDIT.  If  raw  JCL  is  used  to  load  EXECUTION  JCL  file 
sequence  nuabers,  the  nuabers  aust  be  in  raw  JCL. 

WARNING 1  Do  not  dalate  neaber  naae  29999999. 

XXXXXfrDAIA  SET  NAME 

MMMMM- MEMBER  NAME 

(b)  To  execute  procedures  DREAMSP  or  DREAMSB  using  raw  JCL,  leave 
the  DSN-  off  and  insert  the  following: 

/ /DREAMS.  RAWJCUN  DD  DSN- ,D ISP- , DATA, DLM-'  ??' 

RAW  JCL 
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(3)  Tom porary  change  to  execution  JCL  gilt.  If  for  any  reason,  a 
C  asp  or  ary  one- Cilia  change  Co  a  Job  on  the  execution  JCL  file  ia  desired, 
execute  che  following  procedure. 

CLIST  EXECUTION 

samedit  mum 

WHEN  GET  INPUT  LOCK  GOES  CPF,  EDIT  AND  CHANGE  JOBS. 

Note.  To  request  resource  requirements  to  be  re-computed,  insert-  a  //+DBEAMS 
SCAN  card  in  front  of  the  job  card. 

SAVE 

END 

qkkamst  mmn 

When  the  CAT  returns  to  ready,  the  edited  job  will  be  on  the  job  spool. 
QZZSn-JOB  NAME  THAI  IS  TO  BE  CHANGED. 
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SASS  REPORTS  OR  OUTPUTS 
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FIGURE  A-14.  INTER-INTRA  APPLICATION  JOB  DEPENDENCIES. 
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FIGURE  A-16.  CROSS  REFERENCE  BY  JOB  NAHE 


FIGURE 


RMATRIX  ■  UNKNOWN  •  JOB  OEPS  AND  DCP  JOBS  ■  MAR  24  1900  1227 


FIGURE  A- 1 8 .  CROSS  REFERENCE  BY  APPLICATION  NUMBERS. 
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FIGURE  A-19.  CROSS  REFERENCE  BY  FILE  ACRONYM. 
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Appendix  C 

’-.1ST  OF  MMS  OOKMAND  PROCEDURES 


Paragraph 

/« 

a  1ST 

Description  . 

3-5c  (3)  (fc) 

SAnABEND 

POST  A3EKD  FLAG  ON  TON  MATRIX 
A  JOS. 

3-5c (13) 

SAtfCANC 

CANCELS /DELETES  JOGS  FROM 

JOB  SPOOL  PACK. 

3-5c(2£) 

SAfcCOPY 

COPY  MEMBER  FROM  A  PDS  TO 
EXECUTION  JCL  (DS^C. SCRAM. 
EXF.C  JCL). 

3-5c<lS) 

S.VDEL 

DELETE  JG3  FROM  EXECUTION  JCL, 

3-5c(12) 

SAMDI3P/ 

SAND 

DISPLAY  J&JS  SPECIFIC  JCES  ON 
TliE  JCC  SPOOL. 

4-3c(3) 

3 AKZDIT 

1.  TEMP.  UPDATE  TO  EXECUTION 
JCL  (DSN-C .SCliAif  .EXEC  JCL)  . 

2.  PGLLOWED  BY  EREAiCT  WHICH 
EDITS  AND  PUTS  IT  OUT  ON  THE 
SPOOL. 

3-5c (5) (a ) 

SAi-ELT) 

POST  END  TO  RUNNING  MATRIX. 

3-5c(2) 

SAMENV 

DISPLAY  CURRENT  SYSTEM 
ENVIRONMENT. 

3-5c(21) 

SAMGENER 

COPY  MEMBER  FROr.  EXECJCL  TO 
SPOOL  PACK/TO  HOLD  QUEUE. 

3-5c(19) 

SAM  1ST 

LIST  JCb  ON  8X3C  JCL. 

3-5c(17) 

SAMKAffiS 

CISPLAYALL  JOT  SAMS  ON 
EXECUTION  ja. 

*  3-5c(20) (a) 

SAMCOPY 

COPY  MEMBER  FROM  PDS  TO 
EXECUTION  ja. 

3-5c(2f)(t) 

SAMPCPY1 

COPY  MEMBER  FROM  A  PDS  TO 
PERMANENT  JCL  (DSN-C .SAhJCL)  . 

Ifhesi  command 

procedures 

i.re  not  previously  documented 

C-l 


Ease pie 


SAhABEt.D  JN(9999) 
9999  IS  J06TOK 


SAKANC  IQOTX 
XXXX-JOBNAME 

SAKCOPY  XXX(444) 
XXX- PDS 
YYY-M2ii)DR 


SAMDEL  XXXX 
XXX-MEM32K  NAMES 

3AMDIS? 

ENTER  JOE  NAMES 
AFTER  PROiST  JCB1, 
JOE2 

SAMEDIT  XXXX 

DREAM3T  XXXX 
XXX-KSHBER  NANS 


£A«ND  JN(9999) 
9999-JOBNUt-EER  ON 
►ASTER  MATRIX 

SAftEKV 


SAMGENER 

XXX-JOBNAME 

SAM,  1ST  XXX 
XXXX- ME  W3  SR  NAME 

SAMNAMS 


SAMCOPY 


SAMPCPY  XXX(444) 

XXX-PDS 

YYY- MEMBER 


thi9  publ  ication. 
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Paragraph 

CLIST 

Description 

Example 

3-5c(24) 

SAMPEDIT 

1.  TEMP.  UPDATE  TO  PERMAMENT 
JCL.  (ALMSA. SAMJCL) . 

2.  FOLLOWED  BY  DREAMST  WHICH 
EDITS  AND  PUTS  IT  OUT  ON  THE 
SPOOL. 

SAMEDIT  XXXX 

DREAMST  XXXX 

XXXX- JOB NAME 

*  3-5c(25) 

SAMFMAT 

FORMATS  RMATRIX 

SAMFMAT 

3-5c(7) 

SAMPOST 

POST  STATISTICS. 

SAMPOST 

3-5c(3) 

SAMREST 

RESTARTS  JOB  AFTER  ABEND. 

SAMREST  JN(9999) 
9999-MMATRIX  JOBNUM 

3-5c(l)(a) 

SAMRPTA 

SAMRPTAH 

DISPLAY  RMATRIX  OR  HARDCOPY 

OF  RMATRIX. 

SAMRPTA  OR 

SAMRPTAH 

3-5c(l)(c) 

SAMRPTI 

SAMRPTIH 

DISPLAY  JOBS  NOT  COMPLETE 
HARDCOPY  JOBS  INCOMPLETE. 

SAMRPTI  OR 

SAMRPTIH 

3-5c(l)(a) 

SAMRPTJ 

SAMRPTJH 

DISPLAY  RMATRIX  BY  JOB 

HARDCOPY  RMATRIX  BY  JOB. 

SAMRPTJ  OR 

SAMRPTJH 

3-5c( 1 ) (d) 

SAMRPTK 

SAMRPTKH 

DISPLAY  INCOMP. JOBS  BY  JOBNAME 
HARDCOPY  INCOMP.  BY  JOBNAME. 

SAMRPTK  OR 

SAMRPTKH 

3-5c(l)(e) 

SAKRPTR 

DISPLAY  ONLY  JOBS  WITH 

ABEND  OR  START  ONLY. 

SAMRPTR 

3-5c(6) 

SAMRUN 

START  MMS  AFTER  TERM. 

SAMRUN 

3-5c(10) 

SAMSCAN 

STARTS  SCAN  TO  RELEASE  JOBS. 

SAMSCAN 

3-5c(22) 

SAMSPOOL 

LIST  A  JOB  (80  x  80)  ON  THE 
JOBSPOOL  PACK. 

SAMSPOOL  XXXX 

XXXX- JOB NAME 

3-5c(15) 

SAMST 

DISPLAY  STATUS  ON  HOLD  C, 

SPOOL  PACK,  &  PERM.  JCL. 

SAMST 

ENTER  JOBNAMES  AFTER 
PROMPT  JOB1,  JOB2, 
JOB3 
/* 

3  —5c (16) 

SAMSTART 

ACTIVATE  A  JOB  EVEN  IF  MMS 

IS  QUIESCE. 

SAMSTART  XXXX 

XXXX- JOBNAME 

3— 5c ( 5 ) 

SAMTERM 

TERM  OR  QUIESCE  MMS. 

SAMTERM 

C-2 
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Paragraph 

CLIST 

Daaerlptloa 

Exaapla 

3-3c(ll) 

SAMDPD 

UPDATES  RUNNING  IfAXlIZ 
(RMATRXX) . 

SAMOPD. 

2-4(3) 

SASSFLY 

ADD/ DELETE  JOBS  ON  MATRIX 

SASSFLY 

*  2-4(3) 

SASSROH 

CREATE  HEN  RMATRIX 

sassrdr 

*  2-4(3) 

SASSSIM 

SIMULATE  PROCESSING  OF 

JOBS  OH  RMATRXX 

SASSSIM 

*  2-4(2) 

SASSUPD 

UPDATE  MHATRH 

SASSUPD 

2-4c(5)(c) 

SCAMIMQ 

DISPLAT  MASTER  MATRIX 
(MMATRXX)  IHPOR  FOR  SPECIFIC 
APPL.  KAM(S). 

SGAMIHQ  ENTER  APPL 
HAM  AFTER  PROMT 
APPLl,  APPL2,  APPL3 
/* 

2-4c(5)(c) 

SCANIHQ 

DISPLAY  MHATRIX  IHFO  FOR 
SPECIFIC  APPL.  HOMERS. 

SGAHIHQ  ENTER  APPL. 
HOMER  AFTER 

PROMT  APPLl,  APPL2, 
/* 

2-4c(5)(c) 

SCJMZNQ 

DISPLAY  MMATRXX  FOR  SPECIFIC 
JOB  NAMES 

SCJMINQ  ENTER 
JOBHAMS  AFTER 
PROMT  J0B1,  J0B2, 

/* 

2-4c(3)(c) 

SGJNINQ 

DISPLAY  MMATRXX  IHFO  FOR 
SPECIFIC  JOB  HOMERS. 

SCJNZHQ  ENTER  JOB 
HOMER  AFTER  PROMT 

J0BN01,  J0BH02 

/* 


C-3 
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LIST  OF  HMS  CATALOGED  PROCEDURES 


Paragraph 

Procedure 

Description 

4-3 

DREAMS 

OS /HASP  RDR  TO  SAHSPOOL 

4-3 

DREAMS S 

UPDATES  MASTER  MATRIX  RES  FPON 

ALP  LA.  rJ  CL  QuCCX) 

4-3 

DKEAKSE 

RDRC  TO  SAHSPOOL 

*4—3 

UuEAMSP 

ALPHA. Ja  TO  ALMSA.MMS.E5ECJCL 

UPDATES  MASTER  MATRIX 

4-3 

OREAtSR 

SCRATCHES  DREAMS  DATA  SETS  AND  STARTS 
DREAMS  USES  RDR  0CC 

3-5 

SAnABN? 

SAmAUTOP 

POST  ABEHDS  TO  A  JOE 

AUTOMATIC  RESTART  OF  SAUSCAN 

3-5 

SAMCANC? 

CANCELS  JOB(s)  FROfc  JOS  SPOOL 

SAi'COPY? 

ADDS  JOB(S)  TO  JOB  SPOOL 

3-5 

SAUDIS?? 

DISPLAYS  JOD(s)  ON  J03  SPOOL 

3-5 

CAxlDOVNP 

POST  AREN OS  TC  DOWNZI  CPUs 

3-5 

SAKNDP 

POST  END  TO  R-i<AT”IX 

3-5 

SAMENVF 

DISPLAYS  RESOURCES  AVAILABLE  TO  CPU 

3AMGENSP 

PULLS  OFF  EXEC  JCL  TO  3  Ai -SPOOL 

3-5 

SAhPOS  T? 

POST  STATS  TO  M-NATRIX 

3-5 

SAMSEST? 

REMOVES  ABEND  POSTING  AND  SCANS 

3-5 

SAMRPTP 

REPORTS  OF  ALL  JOBS 

3-5 

SAKRUNP 

REMOVES  TERN  POSTING  /  ...  3 CANS 

3-5 

SAWSCANP 

SCANS  P-fATRIX  TO  RELEASE  JOBS 

3-5 

SArtSICiP 

SIMULATION  OF  CURRENTLY  SUNNING  JOSS 

3-5 

SALTERi'? 

QUIESCES'  R-fiATRIX 

D-l 
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Paragraph 

Procedure 

Description 

3-5 

SAMUPDP 

UPDATES  R-MATRIX 

2-4 

3ASSCHKP 

SAME  AS  SASSZMP'  PLUS  INCOMPLETED  JOBS 

ON  R-MATRIX 

2-4 

SASSFLYP 

SAME  AS  SASSRUNP  PLUS  USES 

INCOMPLETED  JOBS  ON  R-MATRIX 

2-4 

SASSFMTP 

CREATES  AND  FORMATS  M-MATRIX  FOR 
SUBSEQUENT  UPDATE  PROCESSING. 

2-4 

SASSBPTP 

PRINT  SELECTED  OR  ALL  JOBS  OF  MASTER 
DATA  BASE  SEGWNTS 

2-4 

SASSRUNP 

INITIALLY  START  UP  A  SCHEDULING  PERIOD 

2-4 

SASSSIMP 

SIMULATE  PROCESSING  OF  JOBS 

2-4 

SASSUPDP 

UPDATE  MASTER  DATA  BASE 

2-5 

SC COMP RP 

COMPARE  TWO  DATA  BASES 

2-4 

SCXREFP 

PRINT  M-MATRIX  PERTAINING  TO 

APPLICATION  NAME ,  NUMBER,  OR  JOBNAME 

D-2 
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t  *<*S  LOC-OW  PL0C2DCTF 


C'SJlCC 

/  /$  ik. 6  TSO 

PROC 

L‘  ■  *  2  .. 

//i3r?rtOC 

EXEC  ?Gfc-IKJEFTDl,DYWAl-JNBR»2  3,TIME-143?,REGIOS-i:!'24y: 

r*  ”  'f  '' 

//3Y5P20C 

DC 

DS  N-AL  RS  A.hKS .  a  IS  T  ,DISP- S  K?» 

*•  *  r»  /  r'  *< 

II 

GL 

L30ALHSA.USE?..CLIST,DISP-SEK 

,^/V  c;  */' 

» _ i.  _/  i- 

// 

nr 

IS  .V  AL  i>3  A .  <1  IS  T  ,PIS?»S  Ktt 

..  k  :.  W  --P  1  • 

//isppll 

DU 

DSOSY31  .ISPPLB.DISP-SHR 

r  * ' 7  *  ^ 

»»  >J\J  /  tm  t> 

// 

CD 

DS  F-  AL  PS  A.  ISPPL  ID  ,C  ISP-3  FA 

;•  •  • «  *  C  i 

//i  j?;lib 

DU 

L3  O  SY3 1  .ISPfL  Es,DIS?-SlTi 

‘  c  ^ 

//IS?  SLID 

CD 

D3>aY£l.I3?3LI3,M£F-S»T. 

:::'i:*f  r 

// 

DO 

DS  O  AL-y-S  A.  I SP  STjL.  ,013? -SID- 

:rii"' 

//ISPPAu.-: 

CD 

03  \«  ALi'-5/..I  DPP  A  \i  I ,  OIS?-  S  HR 

;  l  x  r  i* 

//13PCTL1 

on 

OISP-NT.'/  ,U'w  IT-VIC ,  SPACE  *(CYL  ,(1,1)), 

^  ’  i  ■>  ** 

// 

U  CB  -  ( L  R  l  CL  -  3  3 ,  B  L  FS IZ  r>  2  C  f ,  ?3  CF  f -  £  2 ) 

::h:: 

//ISPCTL2 

DD 

CISP-NEVJ ,0.< IT-VIC, 3? ACS -(CYL,  (1,1)) , 

r:'i5r: 

// 

3CB-(LR£CL-£S,BL?S  IZZ-DDl' ,  ETCrV-FD) 

L';i6:: 

//I3FLST1 

DD 

DISP-NEW ,U.:iT»VIO, SPACE -(CYL ,  (1, 1))  , 

z:\r.z 

/  /  DCl^B(Lrkj,CLa 

■121 ,2LKS  IZE-121 C ,  FZCcf-FtiA) 

L*:i  £;•£ 

/  /I5P7.3T2 

DC 

DISP-i’JEW  ,:J  x  IT- V 10 ,  Sr  AC:.  -(  C YT.  ,(1,1)), 

.  nor  r 

//  OC>{ir3C7,« 

■121 , ELKS  I2E-121 0 ,  Ri'CrT-FDA) 

;.\V2-rc 

//3Y3HTLP 

DD 

DSN-ALnSA.  H£LP,DI3P-31_R 

r."2irc 

// 

f/D 

DSS-SYS1  ,HSLr,UIS?-S’lT; 

:  2  2  r  r 

//SYS  PRINT 

DD 

T£Ri-.-  TS ,  SYS  OUT -A 

,**  ^  2  o  *  ^ 

//SYSTEM 

AC 

TRACTS ,  SYSOUT-A 

r c2Arr 

/  /SY3TSPRT 

DO 

TERr»TS ,  SY30UT-A 

CL25rr 

//SY3IN 

DC 

T3RA—TS ,  3  Y50UT-A 

rrzcsr 

//SY3T5IN 

D  DN  A  fDi  - 1 D  FE  D3  ? 

tail  z 

//IZFRD3E 

DU 

TO  It-TS,  SYSOUT-A 

,  Z2bZl 

//GaaLIN 

DO 

TEWi-TS,  SYS  OUT -A 

;:2  9:c 

//iirf.iJ,; 

DC 

sy50ut-(a,i:tnla) 

f : 3::l 

//ft3  5f?oi 

DD 

TD?.Jj-TS  ,  SYS  COT -A 

fc3K'!' 

U?t:isjzi 

or 

T3  0i'-TS,3  Y3  OUT- A 

iJL  32L  r 

//REPORTS 

DU 

TCR.*»TS ,  SY30UT-A 

C  C  33:’  r 

/  /  M£S3 ACCS 

CD 

TDRF— TS  .3Y30UT-A 

L'  3341'  H 

/  /3  YSOLT 

DD 

TER.:-TS,SY30LT-A 

rc'35C,: 

//Asruori 

DD 

TDl:K-T3,3YS0DT-A 

r “36rr 

//PRINT 

DC 

TDRt  t»  TS ,  S  Y3  CUT  -  A 

r:3  7.;c 

//r?7DUT 

LL 

T3R.'i-TS,3Y30UT-A 

r.r  ?tcr 

/ /3  MATRIX 

DD 

D5N-ALCiS  A.  RMATRIX  ,DISP-SUR 

■  * *5 

//;.;-^::;in 

ID 

Co  N-AL  IP  A.  tli-IAT  AIJC  ,DIS?-3HF. 

f*  ,  r  ' 

Is 

//SANS  POOL 

DD 

D3 1- ALiJS  A .  I  ■  !•  3  .  S  AhS  POOL ,  0 1 S  ?  -  SKI’ 

''C4irr 

//3A>JCL 

CD 

DG  N-  AL  i-fi  A .  P  i !  S .  3  A  !•  J  CL ,  D I S?  -  S  HR 

r:423f 

/  /sent  jcl 

DC 

DS  .>■  AL. .S  A ,fi- j.  riCiDJCL  ,ni3P-S'tR 

334  3_'f 

//JOBSPOOL 

DD 

UJ.-.MY  .DCD-LLNS  IZE-cT 

r  C443 ; 

//dxzcjcl 

DC 

DISP-NE1  , JNIT-VIO,S?ACi-(CYL ,(1,1)), 

C-145C; 

//  Oa-(LRCCL- 

■31 ,3LIT  IZE-til  C,  SiCF^FD) 

3  l  4  6 i . 

/  /sCrtrti.CRL 

DD 

DUP1.Y  ,DC3  -(  ELKS  IZ  F-3 C  , I MFNO- 1  ) 

c  3-*  7  c  r 

//COR.U’JCL 

DD 

DISP-Ne  V  ,IT»1T-vT C  ,£?ACD-(CYL,  ( 1 , 1) )  , 

CC4333 

//  DC3-(Lh 

£JL« 

■8  C  ,  BLKS  IZ  E-3 1'  3 ,  RICF  t  -  FS  ,  ED /NO  1  ) 

£-1 


Error 

number 

0000 


0101 


0119 


0124 


0124 


Appendix  F 
MMS  MISS  AGES 


VARIABLE 

Explanation:  Messages  prefixed  by  0000  are  used  when  requesting 
a  terminal  user  to  enter  data  to  a  SABS  or  SAM  program. 

System  action:  Processing  stops  until  data  or  a  /*  is  entered. 

Peer  response:  Enter  master  or  running  matrix  maintenance  or 
inquiry  request (s). 

SASS  PROCESSING  HAS  TERMINATED  WITH  ERRORS 

Explanation:  One  or  more  errors  has  been  encountered  during  the 
processing  of  a  SASS  program. 

System  action:  Processing  is  terminated. 

User  response:  Review  other  generated  error  messages  to 

determine  error  condition(s) .  Correct  and  resubmit. 

SASS  DATABASE  FORMAT  IS  COMPLETE 

Explanation:  A  new  master  data  base  has  been  created  and 

formatted  with  lov-values  in  preparation  for  initial  updating  or 
conversion. 

System  action:  Processing  continues. 

User  response:  None. 

SASS  PROCESSING  HAS  COMPLETED  NORMALLY 
Explanation:  A  SASS  program  has  completed  normally. 

System  action:  Processing  is  completed. 

User  response:  None. 

SASS  RM1TRIX  HAS  COMPLETED 
Explanation: 

1.  All  the  jobs  on  the  running  matrix  have  completed  normally. 
There  is  nothing  left  for  SAM  to  release. 

2.  A  sinmlation  of  incomplete  jobs  remaining  on  the  running 
matrix  has  been  requested,  but  there  are  no  incomplete  jobs  on 
the  running  matrix. 
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0134 


0147 


0148 


0148 


Appendix  7 — Continued 


System  Action! 

1.  Processing  is  completed. 

2.  Processing  is  termineted. 

Oser  Response* 

1.  Execute  SASSTLY(P),  or  SAMPOST(P)  end  SASSRUN(P),  to  estab- 
lisb  the  next  schedule. 

2.  None. 

SASS  PROCESSING  WILL  CONTINUE 

Explanation*  An  error  or  warning  condition  has  occurred  that  is 
not  critical  enough  to  cause  immediate  program  termination. 

System  Action*  Processing  continues. 

User  Response*  Corrective  action  may  or  may  not  be  required. 

SASS  RMATRIX/ CMATRXX  IS  CREATED 
Explanation* 

1.  The  running  matrix(RMATRIX)  has  been  created  as  a  result  of 
successful  execution  of  SASSRUNP. 

2.  A  temporary  running  matrix  (CMATRIX)  is  created  as  a  result 
of  successful  execution  of  SASS CHRP. 

System  Action;  Processing  continues. 

Oser  Response*  None . 

SASS  MMATRIX  IS  UPDATED 

Explanation;  The  master  matrix  has  been  updated  as  a  result  of  s 
PMOD  change  (SASSDPDP)  or  statistics  posting  of  jobs  completed  on 
the  running  matrix  (SASS7LYP)  or  SAMPOST(P)). 

System  Action*  Processing  continues. 

Oser  Response*  None. 

SASS  RMATRIX  IS  UPDATED 

Explanation* 

1.  The  running  matrix  has  been  updated  as  a  result  of  a  TMOD 
update,  fly  add,  fly  delete,  or  statistics  posting  and  purge 
through  SASSFLYP. 
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0150 


0163 


0204 


0205 


Appendix  F— Continued 

2.  The  running  matrix  has  been  updated  as  a  result  of  job  start, 
end,  ABEND  posting  by  the  SAMEND  program,  or  an  update  by 
SAMUPD(P),  or  statistics  posting  and  purge  by  8A8SFLYP  or 
SAlffOST(P). 

System  Action:  Processing  continues. 

Oser  Response:  None . 

SASS  RMATRLX  CURRENTLY  BEING  QUIESCED 

Explanation:  The  running  matrix  has  been  quiesced  (termed)  in 

order  to  prevent  further  releasing  of  jobs  by  the  SAMEND  pro¬ 
gram.  This  is  the  first  of  two  messages  (ref  3135). 

Systen  Action:  Processing  continues. 

User  Response:  To  remove  the  TERM  execute  SAMRUN(P),  otherwise 
no  response  is  not  necessary. 

SASS  RMATRIX  WILL  BE  ACTIVATED/QUIESCED 

Explanation: 

1.  The  term  is  removed  from  the  running  matrix  and  a  scan  is 
initiated  to  allow  jobs  to  release. 

2.  The  running  matrix  is  being  quiesced  (termed)  to  prevent  the 
release  of  jobs. 

System  Action:  Processing  continues. 

User  Response:  None . 

INPUT  DATA  NOT  RECEIVED 

Explanation:  No  update  requests  were  input  to  the  SAMUPD  program. 
System  Action:  Processing  is  terminated. 

User  Response:  Submit  update  requests  and  rerun. 

INPUT  FOR  ' _ '  NOT  FOUND 

Explanation:  A  control  statement  (e.g.,  ./  FLY  ADD)  has  been 

processed  with  no  input  data  statements. 

System  Action:  The  control  statement  is  rejected.  Processing 
continues . 

User  Response:  Re-enter  control  statement  (card)  with  data 

statements  (cards)  following  it. 
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0223  INPUT  DATA  IS  MISSING  FOR  ' _ ' . 

Explanation:  An  input  control  statement  associated  with  the 

function  being  executed  (e.g.,  ./  PMOD  MATRIX  for  the  execution 
of  SASSUPDP)  was  not  processed. 

System  Action:  Processing  continues. 

User  Response:  Enter  the  control  stateaents  (cards)  associated 
with  the  function  being  executed. 

0306  DATA  CARD  WITH  NO  CONTROL  CARD 

Explanation:  A  data  statement  (card)  has  been  processed  with  no 
preceding  control  statement  (card)  in  the  execution  of  a  function 
requiring  both. 

System  Action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  Response:  Correct  and  re-enter. 

0309  DATA  FOR  KEYWORD  1 _ 1  EXCEEDS  MAX  LENGTH 

Explanation:  The  input  data  for  a  keyword  exceeds  the  maximum 

length  allowed. 

System  Action:  The  data  statement  (card)  is  rejected.  Process¬ 

ing  continues. 

User  Response:  Correct  and  re-enter. 

0310  DATA  FOR  KEYWORD  ' _ '  EXCEEDS  COL  71 

Explanation:  The  data  for  a  keyword  exceeds  column  (or  position) 
71. 

System  Action:  The  statement  (card)  is  rejected.  Processing 

continues . 

User  Response:  Correct  and  re-enter. 

0315  DATA  CARD  NOT  VALID  W/ PRIOR  ERRORS  ENCOUNTERED 

Explanation:  An  error  has  been  detected  in  a  prior  card  or  con¬ 
tinuation  card  that  nullifies  all  continuation  cards  associ-  ated 
with  the  action  to  be  performed. 

System  Action:  The  continuation  cards  are  rejected.  Processing 
continues . 

User  Response:  Correct  and  re-enter  the  transaction  and  all 

continuation  cards  (statements). 
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0318  DATA  FOR  KEYWORD  ' _ '  IS  INVALID, 

Explanation:  The  date  for  a  keyword  contains  an  incorrect  value 
or  format. 

System  Action:  The  stateaent  (card)  is  rejected.  Processing 

continues. 

User  Response:  Correct  and  re-enter. 

0321  DATA  FOR  KEYWORD  ' _ '  NOT  SPECIFIED 

Explanation:  No  value  was  entered  for  a  keyword. 

System  Action:  The  stateaent  (card)  is  rejected.  Processing 

continues. 

User  Response:  Correct  and  re-enter. 

0322  DATA  CARD  WITH  NO  DATA 

Explanation:  A  statement  (card)  was  encountered  with  no  data 

prior  to  position  (column)  72. 

System  Action:  The  statement  (card)  is  rejected.  Processing 

continues. 

User  Response:  Correct  and  re-enter. 

0.  8  DATA  FOR  KEYWORD  ' _ '  REQUIRES  PARENS 

Explanation:  Keywords  that  have  a  variable  number  of  entries 
associated  with  them  (e.g.,  FN*(S03,  U52))  must  have  their  values 
enclosed  in  parentheses. 

Sy^em  Action:  If  the  values  are  not  enclosed  in  parenthesis, 

then  the  statement  (card)  is  rejected.  Processing  continues. 

User  Response:  Correct  and  re-enter. 

0409  PARM  DATA/ENTRY  NAME  EXCEEDS  MAX  LENGTH. 

Explanation:  Either  the  entire  parameter  field  or  one  of  the 

sub-parameters  exceeds  the  maximum  length  allowed. 

System  action:  Processing  is  terminated. 

User  response:  Correct  parameter  field  entry  and  rerun. 
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0417  FARM  DATA/ENTRY  NAME  IS  OMITTED 

Explanation:  Either  the  entire  parameter  field  or  one  of  the 

sub-parameters  has  been  omitted.  *“ 

System  action:  Processing  is  terminated. 

User  response:  Enter  the  parameter  field(s)  missing  and  rerun. 

0418  PARM  entry  name  ' _ 1  IS  INVALID 

Explanation:  A  sub-parameter  is  invalid. 

System  action:  Processing  is  terminated. 

User  response:  Refer  to  documentation  in  chapter  2  or  3  for  cor¬ 
rect  symbolic,  or  parameter,  values.  Correct  and  re-enter. 

0428  PARM  JOBNUM  ' _ '  DOES  NOT  EXIST  IN  RMATIX 

Explanation:  Using  the  master  matrix  job  number  (JOBNUM)  a  scan 
was  initiated  on  the  running  matrix  for  a  job  containing  that 
master  matrix  number.  No  job  was  found. 

System  action:  Processing  is  terminated. 

User  response:  Add  uhe  job  to  the  running  matrix  or  correct  the 
symbolic  value  and  re-enter. 

0504  EXPECTED  CONTINUATION  NOT  RECEIVED 

Explanation:  The  last  statement  (card)  processed  ended  with  a 

comma  followed  by  a  blank  indicating  a  continuation  statement 
(card)  would  follow.  A  continuation  statement  (blank  in  position 
or  column  1)  was  not  encountered. 

System  action:  All  preceding  statements  associated  with  the  same 
request  are  nullified.  Processing  continues. 

User  response  Correct  and  re-  inter. 

0607  SKIPPING  UNTIL  NEXT  CONTROL  CARD 

Explanation:  An  error  has  been  encountered  in  a  control  state¬ 
ment  (card). 

System  action:  All  data  statements  (cards)  following  the  control 
statement  in  error  are  bypassed. 

User  response:  Correct  and  re-enter  the  control  and  data  state- 
ments  (cards). 
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0702  OPERATION  ' _ '  HOT  PERMITTED  WICT  PAEM  REQUEST 

Explanation:  The  control  statement  (card)  operation  specified  is 
mutually  exclusive  with  the  execution  function. 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 

User  response:  Refer  to  Table  2-1  for  allowable  oper-  at ions. 
Correct  and  re-enter . 

0709  OPERATION  STARTING  IN  COL  1 _ '  EXCEEDS  MAX  LENGTH 

Explanation:  The  control  statement  (card)  operation  exceeds  the 
maximum  length  allowed. 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  response:  Correct  and  re-enter. 

0710  OPERATION  EXCEEDS  COL  71 

Explanation:  The  control  statement  (card)  operation  exceeds 

position  (column)  71. 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  response:  Correct  and  re-enter. 

0718  OPERATION  ' _ '  IS  INVALID 

Explanation:  The  operation  specified  on  the  control  statement 

(card)  is  inva 1 id . 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continue s . 

User  response:  Correct  and  re-enter. 

0721  OPERATION  NOT  SPECIPIED 

Explanation:  No  operation  was  specified  on  a  control  statement 

(card)" - 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  response:  Correct  and  re-enter. 
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0602  OPERAND  NOT  PERMITTED  WITH  RUN 

Explanation:  No  operand  is  permitted  if  the  control  statement 
(card)  operation  ia  RUN. 

System  action:  The  control  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 

User  response:  Remove  the  operand  and  re-enter. 


0609  OPERAND  STARTING  IN  COL  ' _ '  EXCEEDS  MAX  LENGTH 

Explanation:  The  control  statement  (card)  operand  exceeds  the 

maximum  length  allowed. 

System  Action:  The  control  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 


User  Response:  Correct  and  re-enter. 

0610  OPERAND  EXCEEDS  COL  71 

Explanation:  The  control  statement  (card)  operand  exceeds  posi¬ 
tion  (column)  71. 

System  Action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  Response:  Correct  and  re-enter. 

0818  OPERAND  » _ *  IS  INVALID 

Explanation:  The  control  statement  (card)  is  invalid  for  the 

operation  specified. 

System  Action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  Response:  Correct  and  re-enter. 

0621  OPERAND  NOT  SPECIFIED 

Explanation:  No  operand  was  specified  on  a  control  statement 

(card)  requiring  one. 

System  Action:  The  control  statement  (card)  is  rejected.  Pro¬ 

cessing  continues. 

User  Response:  Refer  to  chapter  2  for  valid  operands  for  each 

operation.  Correct  and  re-enter. 
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0914  PMOD  IS  MUTUALLY  EXCLUSIVE  WITH  PRIOR  TMOD 

Explanation:  The  operation  HOD  baa  already  been  encountered  in 
the  input  stream.  Temporary  and  permanent  aaater  matrix  updates 
may  not  be  mixed  in  one  execution. 

System  Action:  The  control  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 

User  Response:  Submit  the  permanent  changes  in  a  separate  execu- 
tion  of  SASSUPDP. 

1014  TMOD  MUTUALLY  EXCLUSIVE  WITH  PRIOR  PMOD 

Explanation  The  operation  PMOD  has  already  been  encountered  in 
the  input  stream.  Permanent  and  temporary  master  matrix  updates 
may  not  be  mixed  in  one  execution. 

System  Action:  The  -control  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 

User  Response:  Submit  the  temporary  changes  in  a  separate  execu¬ 
tion  of  SASSUPDP. 

1102  KEYWORD  OTHER  THAN  AC,  JN,  AND  JM/ OTHER  THAN  AC,  AN,  AND  AM/OTHER 
THAN  AC,  FN,  AND  FM  NOT  PERMITTED  WITH  DELETE 

Explanation:  When  deleting  a  master  matrix  job,  application,  or 
file;  only  the  action  of  delete  and  the  job  number  and  name, 
application  number  and  name,  or  file  number  and  name  may  be 
specified. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  Response:  Correct  and  re-enter. 

1102  KEYWORD  OTHER  THAN  JN  NOT  PERMITTED  WITH  RM 

Explanation:  When  requesting  that  a  running  matrix  job  be 

deleted  (RM* DELETE)  or  cleared  (R1MILEAR)  through  SAMUPD(P),  only 
the  keywords  RM  and  JN  are  allowed. 

System  Action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  Response:  Correct  and  re-enter. 
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1102  KEYWORD  RM  NOT  PERMITTED  WITH  ADD 

Explanation:  When  the  SAMUPD  program  has  determined  that  the 

update  request  is  a  job  add,  then  the  keyword  RM  is  not  permitted. 

System  Action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

Peer  Response:  Correct  and  re-enter. 

1109  KEYWORD  STARTING  IN  COL' _ '  EXCEEDS  MAX  LENGTH 

Explanation:  The  keyword  exceeds  the  maximum  length  allowed. 

System  action:  The  data  statement  (card)  is  rejected.  Pro¬ 
cessing  continues. 

User  response:  Correct  and  re-enter. 

1110  KEYWORD  STARTING  IN  COL' _ '  EXCEEDS  COL  71 

Explanation:  The  keyword  exceeds  position  (column)  71. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 

1113  KEYWORD  ' _ '  MUTUALLY  EXCLUSIVE  WITH 

Explanation: 

1.  Keyword  "FS"  (files  reset)  is  mutually  exclusive  with  all 
other  keywords. 

2.  Keyword  "ND"  (set  the  number  of  devices  for  a  file)  is 
mutually  exclusive  with  all  other  keywords. 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  response:  Correct  and  re-enter. 

1118  KEYWORD  STARTING  IN  COL  ' _ *  IS  INVALID 

Explanation:  An  unrecognizable  keyword  has  been  encountered  on  a 
data  statement  (card). 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  Response:  Correct  and  re-enter. 
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1121  KEYWORD  ' _ '  WOT  SPECIFIED 

Explanation:  A  keyword  required  for  a  particular  action  to  be 
performed  waa  not  apecified. 

System  action:  In  data  statement  (card)  is  rejected.  Processing 
continues. 

Pser  response;  Supply  required  keyword  (ref  chap  2  or  3)  and 
re-enter. 

1131  KEYWORD  ' _ '  IS  DUPLICATE 

Explanation:  A  duplicate  keyword  has  been  encountered  on  the 

same  data  statement  (card)  or  continuation. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response  Correct  and  re-enter. 

1158  KEYWORD  ' _ '  MUST  BE  SPECIFIED  FOR  ADD 

Explanation:  The  keywords  JN(job  number),  DN  (master  matrix  job 
number),  and  JM  (job  name)  must  be  specified  for  a  job  add  to  the 
running  matrix  through  the  SAMUPD  program.  One  of  these  keywords 
is  missing. 

System  action:  Data  statement  (card)  is  rejected. 

User  response:  Correct  and  re-enter. 

1279  TRANS  BYPASSED 

Explanation:  A  data  statement  following  a  rejected  control 

statement  is  bypassed  in  processing. 

System  action:  Data  statements  are  bypassed  until  a  control 

statement  or  end  of  file  is  encountered. 

User  response:  Correct  the  control  statement  (card),  and 

re-enter  both  the  control  and  associated  data  statement(s) . 

1326  VALUE  FOR  KEYWORD  ' _ '  LESS  THAN  MINIMUM 

Explanation:  The  numeric  value  for  a  keyword  is  less  than  the 

minimum  allowed. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 


P-11 


Vol.  15,  CCSSOI  18-320 


1327 


1416 


1418 


1428 


Appendix  F— Continued 

VALUE  FOR  KEYWORD  * _ '  GREATER  THAN  MAXIMUM 

Explanation:  The  numeric  value  for  a  keyword  is  greater  than  the 
maximum  allowed. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 

DEPENDENCY  ERROR(S)  ENCOUNTERED  DURING  SIMULATION 

Explanation:  One  or  more  dependency  errors  have  been  encountered 
during  simulation  (e.g.,  job  backs  off  to  itself).  This  is  the 
first  of  three  messages  (ref  3100  (INITS  EMPTY)  and  3136). 

System  action:  Processing  is  terminated. 

User  response:  Review  error  messages;  correct  job(s)  dependency 
field(s)  in  the  master  matrix  and  rerun. 

DEPENDENCY  NUMBER  ' _ '  IS  INVALID 

Explanation: 

1.  The  dependency  number  specified  on  the  data  statement  to 

update  the  master  matrix  does  net  fall  in  the  range  of  absolute 
numbers  1  through  3525. 

2.  The  dependency  number  specified  on  the  data  statement  to 

update  the  running  matrix  does  not  fall  in  the  range  of  1  through 
555. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 

ing  continues. 

User  response:  Correct  and  re-enter. 

DEPENDENCY  ' _ '  DOES  NOT  EXIST  IN  MMATRIX/RMATRIX 

Explanation: 

1.  In  a  master  matrix  update,  the  job  specified  by  the  depend¬ 
ency  number  does  not  exist  (is  not  in  use)  in  the  master  matrix. 

2.  In  a  running  matrix  update,  the  job  specified  by  the  depend¬ 
ency  number  does  not  exist  (is  not  in  use)  in  the  running  matrix. 

System  action:  The  data  statement  (card)  is  rejected.  Process- 
ing  continues. 

User  response:  Correct  and  re-enter. 
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1431  DEPENDENCY  NUMBER  ' _ '  IS  DUPLICATE  IN  PARAMETER  LIST 

Explanation:  A  dependency  number  in  the  keyword  DP  parameter 

list  occur*  sore  then  once. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Remove  duplicate  dependency  numbsr(s)  and  re¬ 
enter. 

1480  DEPENDENCY  NUMBER  ' _ '  MAY  ROT  EQUAL  JOBNUM 

Explanation:  A  job  number  to  be  updated  may  not  specify  a 

dependency  equal  to  itself. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 

1518  NUMBER  DEVICES  ' _ ’  IS  INVALID 

Explanation:  In  the  running  matrix  file  update,  the  number  of 
devices  specified  for  the  ND  keyword  is  not  numeric  (from  1 
through  99). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  response:  Correct  and  re-enter. 

1527  NUMBER  OF  DEPENDENCIES/OF  FILES  GR  THAN  MAXIMUM 
Explanation: 

1.  The  number  of  dependencies  specified  for  a  job  exceeds  the 
maximum  of  12. 

2.  The  number  of  files  specified  for  a  job  exceeds  the  maximum 
of  9. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 
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NUMBER  OF  DEPS  FOR  JOB  ' _ '  EXCEEDS  MAXIMUM 

Explanation i  The  dependency  optiaizer  proceaa  (executes  before 
the  actual  job  simulation),  in  determining  a  job's  dependencies 
from  the  jobs  that  are  scheduled,  found  more  than  12  dependencies. 

System  action:  Processing  is  terminated. 

Peer  response:  TMOD  the  12  most  important  dependencies  to  the 
job  and  re-run. 

FILE  REPORT  NOT  PERMITTED  WITH  TERMINAL  MODE 

Explanation?  A  control  staement  requesting  the  files  report  (./ 
REPORT  FILES)  was  encountered  while  executing  through  TSO.  This 
option  is  not  permitted  under  TSO  because  of  the  report  width. 

System  action:  Control  statement  is  bypassed.  Processing  con¬ 
tinues. 

Dser  response:  Create  the  report  through  batch. 

PILE  NUMBER/ MODE / STATUS  ' _ '  IS  INVALID 

Explanation: 

1.  The  file  number  specified  on  the  data  statement  (card)  does 
not  fall  in  the  range  of  n\od>ers  1  through  255. 

2.  The  file  mode  specified  on  a  job  update  data  statement  (card) 
does  not  equal  R  (reference),  U  (update),  S  (share),  or  E  (exclu¬ 
sive-use). 

3.  The  file  status  specified  on  a  file  segment  update  against 
the  running  matrix  does  not  equal  L  (lock),  X  (lock  except  for 
reference  users),  or  F  (clear  the  current  file  status  and  reset 
with  current  status,  and  number  of  users,  based  on  a  scan  of  the 
running  matrix). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  response:  Correct  and  re-enter. 

FILE  NUMBER  ' _ '  DOES  NOT  EXIST  IN  MMATRIX 

Explanation:  The  file  number  specified  is  not  active  in  the  mas¬ 
ter  matrix. 
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Systea  act ion:  The  date  atateaent  (card)  is  rejected.  Process¬ 
ing  continues. 

Peer  response:  Correct  and  re-enter. 

1650  FILE  ' _ '  CURRENTLY  BEING  UPDATED/ SHARE D/ LOCKED /XLOC RED /RXCL 

USED/REFEBENCED 

Explanation:  The  user  has  requested  that  a  start  be  posted  to  a 
job  on  the  running  aatrix.  The  job  requests  a  file  in  a  node 
that  is  in  conflict  with  the  current  file  status.  This  is  the 
first  of  two  aessages  (ref  3118). 

Systea  action:  The  data  stateaant  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Change  the  status  of  the  file  by  posting  other 
jobs  as  conplete,  remove  file  lock  or  XLOCK,  etc.,  and  re-enter. 

1653  FILE  NAME/NUMBER  ' _ '  ALREADY  EXISTS  IN  MATRIX 

Explanation 

1.  The  file  name  already  exists  in  the  ouster  aatrix  invalida¬ 
ting  the  file  add  or  naae  change  request. 

2.  The  file  nuaber  specified  on  a  file  add  is  already  in  use  in 
the  aaster  aatrix. 

System  action:  The  data  stateount  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 

1654  FILE  NUMBER  IS  DUPLICATE  IN  PARAMETER  LIST 

Explanation:  A  file  nuaber  in  the  keyword  'FN'  parameter  list 

occurs  aore  than  once. 

User  response:  Remove  duplicate  file  nuoiber(s)  and  re-enter. 

1666  FILE  NAME  ' _ '  DOES  NOT  MATCH  MMATRIX 

Explanation:  The  file  naae  specified  on  a  file  delete  data 

statement  does  not  match  the  master  oiatrix  file  name. 

System  action:  The  data  statement  is  rejected.  Processing 
continues . 

User  response:  Correct  and  re-enter. 
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1733  EQUAL  SIGN  IN  COL  ' _ '  WITH  NO  PRECEDING  KEYWORD 

Explanation:  An  equel  sign  wee  encountered  on  e  date  statement 
with  no  preceding  keyword. 

Sy at—  action:  The  data  statement  ia  rejected.  Proceaaing 
continues. 

Peer  Reaponae:  Correct  and  re-enter. 

1802  APPL  REPORT  NOT  PERMITTED  WITH  TERMINAL  MODE 

Explanation:  A  control  8tatement  requesting  the  application 

report  ( . /  REPORT  APPL)  was  encountered  while  executing  through 
TSO.  Thia  option  ia  not  permitted  under  TSO  because  of  the 
report  width. 

System  action  The  control  statement  is  bypassed.  Processing 
continues. 

User  response:  Create  the  report  through  batch. 

1828  APPL  NAME/NUMBER  ' _ ’  DOES  NOT  EXIST  IN  MMATRIX 

Explanation: 


1.  The  application  name  specified  does  not  exist  in  the  master 
matrix. 

2.  The  application  number  specified  does  not  exist  in  the  master 
matrix. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues 

User  response:  Correct  and  re-enter. 

1853  APPL  NAME/NUMBER  ' _ '  ALREADY  EXISTS  IN  MMATRIX 

Explanation: 

1.  The  application  name  specified  on  an  application  add  or  name 
change  already  exists  in  the  master  matrix. 

2.  The  application  number  specified  on  an  application  add  is 
already  in  osa  in  the  master  matrix. 

Syst—  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

Osar  response:  Correct  and  re-enter. 
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1866  APPL  NAME  ' _ '  DOES  NOT  MATCH  HMAIRLX 

Exp 1 net ion:  The  application  name  specified  on  an  application 
delete  data  statemnt  does  not  natch  the  master  matrix  applica¬ 
tion  none. 

System  action:  The  data  statemnt  (card)  is  rejected. 

Processing  continues. 

User  response:  Correct  end  re-enter. 

1900  JOB  ADDED  /^DELETED/ CLEARED / DP DATED 

Explanation?  This  message  is  displayed  after  each  user  request 
against  a  job  on  the  running  Matrix  baa  been  accomplished 
(through  SAMDPD(P)). 

System  action:  Processing  continues. 

User  response:  None'. 

1921  JOB  CHANGE  MOT  SPECIFIED 

Explanation:  No  keyword  other  than  Jl  (job  number)  was  entered 
on  the  data  statement  (card). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  response:  Correct  and  re-enter. 

1924  JOB  ' _ '  HAS  COMPLETED  NORMALLY /ABNORMALLY/PREVIOUSLY 

Explanation: 

1.  A  job  has  completed  normally  or  abnormally. 

2.  The  running  matrix  job  entry  reflects  that  the  job  has 
already  been  posted  with  a  job  completion. 

System  action: 

1.  The  <job  entry  is  posted  with  completion  type,  time,  and 
elapsed  time.  If  the  job  ABENDS  field  is  updated  and  files  used 
in  update,  share,  or  exclusive-use  mode  are  locked,  a  scan  is 
initiated  against  the  running  matrix  for  jobs  to  release. 

2.  No  posting  is  done  to  the  job  entry.  A  scan  is  initiated 
against  the  running  matrix  for  jobs  -to  release. 

User  response:  None. 
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1928  JOB  NAME/NUMBER  ' _ '  DOES  HOT  EXIST  IH  MMATR1X 

Explanation: 

1.  The  job  name  to  be  fly  added,  fly  deleted,  or  run  does  not 
exist  in  the  master  matrix. 

2.  The  job  number  specified  on  the  data  statement  (card)  does 
not  exist  in  the  master  matrix. 

System  action: 

1.  Processing  continues,  but  if  processing  in  batch  mode,  the 
fly  (check)  or  run  and  the  simulation  are  terminated. 

2.  The  data  statement  (card)  is  rejected.  Processing  continues. 
User  response:  Correct  and  re-enter. 

1928  JOB  ' _ '  DOES  NOT  EXIST  IN  MMATRIX 

Explanation: 

1.  A  completed  job  on  the  running  matrix  does  not  exist  on  the 
master  matrix  (may  have  been  a  one  time  only  add). 

2.  An  incomplete  job  on  the  running  matrix  does  not  exist  on  the 
master  matrix. 


System  action: 


1. 

The 

job's  run  statistics  are 

not  posted 

to 

the  master 

matrix. 

Processing  continues. 

2. 

The 

job  is  included  in  the 

simulation, 

and 

processing 

continues 

User  response:  None . 

1928  JOB  ' _ '  DOES  NOT  EXIST  IN  RMATRIX 

Explanation:  The  job  number  specified  on  an  update  request 

against  the  running  matrix  does  not  exist  (is  not  in  use). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 

User  response:  If  the  job  is  to  be  added,  specify  JM  (job name) 
and  1)N  (master  matrix  job  number);  otherwise  correct  the  JH  (job 
number),  and  re-enter. 
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1928  JOB  TO  BE  FLY  DELETED  ' _ '  DOES  NOT  EXIST  IN  RMATRIX 

Explanation:  A  job  naan  to  be  lly  deleted  ia  not  found  on  the 
running  matrix. 

System  Action?  Processing  continues. 

Peer  response:  Rone. 

1928  JOB  NAME  ’ _ ’  DOES  NOT  EXIST  IN  RMATRIX /HOLD  QUEUE 

Explanation: 

1.  The  job  name  to  be  processed  by  the  8AMEND  program  does  not 
exist  in  the  running  matrix. 

2.  A  job  on  the  running  matrix  to  be  released  under  HASP  does 
not  exist  in  the  hold  queue. 

System  action:  Processing  is  terminated. 

User  response: 

1.  Add  the  job  to  the  running  matrix  and  rerun. 

2.  Read  the  job  into  the  hold  queue  and  rerun. 

1937  JOB  NAME(S)  TO  BE  RUN  NOT  SPECIFIED 

Explanation:  No  job  or  application  names  were  specified  on  the 
data  statement  (card)  following  the  ./  RUN  control  statesmnt. 

System  action:  Processing  continues,  but  the  run  and  simulation 
functions  are  terminated. 

User  response:  Specify  job  or  application  name(s)  and  re-enter. 

1938  JOB  NAME(S)  TO  BE  FLY  ADDED  NOT  SPECIFIED 

Explanation:  No  job  or  application  names  were  specified  on  the 
data  statement  (card)  following  the  ./  FLY  ADD  control  statement. 

System  action:  Processing  continues,  but  the  fly  (check)  and 
simulation  functions  are  terminated. 

User  response:  Specify  job  or  application  names  and  re-enter. 


\ 
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1939  JOB  NAME(S)  TO  BE  FLY  DELETED  NOT  SPECIFIED 

Explanation:  No  job  or  application  names  were  specified  on  the 
data  statement  (card)  following  the  ./  FLY  DELETE  control  state¬ 
ment. 

System  action:  Processing  continues,  but  the  fly  (check)  and 
simulation  functions  are  terminated. 

User  response:  Specify  job  or  application  names  and  re-enter. 

1939  JOB  ' _ '  TO  BE  FLY  DELETED  DOES  NOT  Eli ST  IN  RMATRIX 

Explanation:  A  job  specified  on  the  data  statement  (card)  to  be 
fly  deleted  does  not  exist  on  the  running  matrix. 

System  action:  Processing  continues. 

Peer  response:  None . 

1939  JOB  ' _ '  TO  BE  FLY  DELETED  IS  EXECUTING 

Explanation:  A  job  specified  on  the  data  statement  (card)  to  be 
fly  deleted  is  represented  on  the  running  matrix  as  still  execut¬ 
ing  (i.e.,  start  and  no  end  or  ABEND  is  posted).  The  job  is  not 
deleted  from  che  running  matrix.  This  is  the  first  of  two  mes¬ 
sages  (ref.  3159,  DELETE  NOT  INVOKED). 

System  action:  Processing  continues. 

User  response:  Either  delete  the  job  through  SAHUPD(P),  or  post 
a  completion  to  the  job  through  SAMEND(P).  In  the  latter  option, 
SASS  will  automatically  delete  the  job  from  the  running  matrix  in 
the  next  execution  of  SASSFLY(P). 

1941  JOB  1 _ '  EXCEEDS  MAXIMUM  SYSTEM  RESOURCES 

Explanation:  A  job  to  be  simulated  requests  more  than  the  system 
maximum  amount  (ma^>er)  of  a  particular  resource  (e.g.,  Tape  9, 
CORE). 

System  action:  Processing  is  terminated. 

User  response:  Review  the  resources  required  by  the  job  in  the 
master  matrix,  or  run  matrix  and  correct  the  resource  requirement 
that  is  in  error. 

1950  JOB  ' _ '  CURRENTLY  BEING  RESTARTED 

Explanation:  An  ABENDed  job  is  being  restarted  through  the  exe¬ 
cution  of  SAMREST(P). 
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System action :  The  job  is  restarted.  File  locks  are  removed 
from  files  that  the  job  used  in_shar«,  update,  or  exclusive-use 
•ode.  A  scan  is  initiated  against  the  running  matrix  for  other 
jobs  to  release. 

User  response:  Hone . 

1953  JOB  NAME/NUMBER  ALREADY  EXISTS  IH  MMAIRIX 
Explanation: 

1.  The  job  naae  specified  on  a  job  add  or  naae  change  data 
statement  already  exists  in  the  awster  matrix. 

2.  The  job  number  specified  on  a  job  add  is  already  in  use  in 
the  master  matrix. 

System  action:  The  data  statement  (card)  is  rejected. 

Processing  continues. 

User  response:  Correct  and  re-enter. 

1953  JOB  NAME  ’ _ '  ALREADY  EXISTS  IH  RMATRIX 

Explanation:  The  job  name  specified  on  a  job  add  or  name  change 
already  exists  in  the  running  matrix  for  a  different  job  number. 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues . 

User  response:  Correct  and  re-enter. 

1953  JOB  TO  BE  FLY  ADDED  1 _ '  ALREADY  EXISTS  IH  RMATRIX. 

Explanation:  The  job  name,  specified  on  a  data  statement,  to  be 
fly  added  already  exists  on  the  running  matrix. 

System  action:  Processing  continues. 

User  response:  Hone . 

1964  JOB  ' _ '  HAS  ABENDED  PRIOR  TO  NORMAL  END 

Explanation:  A  job  that  has  ABENDed  prior  to  normal  end  is 

automatically  deleted  from  the  running  matrix  in  the  execution  of 
the  fly  function,  but  no  statistics  are  posted  to  the  master 
matrix.  This  is  the  first  of  three  messages  (ref  3167  and  3170). 

System  action:  Processing  continues. 

User  response:  Hone . 
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1966  JOB  NAME  ' _ '  DOES  NOT  MATCH  MMATRIX 

Explanation:  The  job  naae  specified  on  a  job  delete  data  state- 
■eot  does  not  Batch  the  master  matrix  job  name. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

Oser  response:  Correct  and  re-enter. 

1966  JOB  ' _ ’  DOES  NOT  MATCH  MMATRIX 

Explanation: 

1.  A  completed  job  on  the  running  matrix  does  not  match  the  mas¬ 
ter  matrix  jobname.  Statistics  are  not  posted  to  the  master 
matrix,  but  the  job  is  deleted  from  the  running  matrix.  This  is 
the  first  of  three  messages  (ref  3167  and  3170). 

2.  An  incomplete  job  on  the  running  matrix  does  not  match  the 
master  matrix  job  name. 

System  action: 

1.  Processing  continues. 

2.  Processing  is  terminated. 

User  response: 

1 .  None . 

2.  Change  the  running  matrix  job's  master  matrix  numL..  (through 
SAMUPIKp))  to  a  master  matrix  number  not  in  use,  and  re-run. 

.1967  JOB  START  NOT  POSTED  TO  RMATRIX 

Explanation:  (Jser  is  Crying  Co  post  an  end  or  ABEND  to  a  job  on 
the  running  matrix  which  has  not  been  posted  with  a  start.  This 


is  the  first  of 

two  me 

ssages  (ref  3118). 

System  action: 
continues. 

Data 

statement  (card) 

is  rejected. 

Processing 

User  response: 

Add 

a  start  time  to 

the  update 

request  and 

re-enter. 
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JOB  ' _ '  PROCESSED  TO  EOJ 

Explanation!  All  job  aan  printed  fra  the  runnint  Mtris  hm 
procaaaed  to  normal  completion  under  the  control  of  SCRAM.  This 
ie  the  firat  of  two  meaaage*  (ref  3182).  Bun  etetiatica  are 
poated  to  the  neater  matrix. 

Syaten  actioni  Procaaaing  continue*. 

Daer  reaponae:  Bone . 

JOB  ' _ '  PROCESSED  TO  EOJ  OUTSIDE  SASS 

Explanation:  All  job  nanea  printed  freai  the  running  matrix  hare 
proceaaed  to  normal  completion,  but  waa  not  atarted  under  SCRAM 
control.  Run  atatiatica  are  not  poated  to  the  neater  matrix. 
Thia  ia  the  firat  of  two  meaaage*  (ref  3167). 

Syaten  action:  Procaaaing  continue*. 

Uaer  reaponae:  None . 

JOB  * _ '  DELETED  FROM  RMATRXX 

Explanation:  In  the  execution  of  the  fly  (or  chk)  proceaa  thia 
meaaage  ia  produced  whenever  SASS  delete*  a  job  from  the  RMATRIX, 
either  automatically  becauae  the  job  ia  completed  or  by  uaer 
requeat. 

Syaten  action:  Procaaaing  continue*. 

Uaer  reaponae:  None . 

JOB  ' _ '  SELECTED  -  NOT  RELEASE  AT  ' _ ' 

Explanation:  A  job  ha*  ben  aelected  aa  available  for  releaae  in 
aiaulation,  or  actual  ayatem  scheduling,  but  external  criteria 
prevent  ita  releaae  (e.g.,  initiator*  unavailable,  core,  device* 
unavailable,  file(a)  used  in  conflicting  mode,  etc.)  The  time 

that  the  job  waa  aelected  ia  diaplayed.  Thia  ia  the  firat  of 
three  meaaage*  (ref  number  3149,  3150,  3171,  and  3172). 

Syaten  action:  Procaaaing  continue*. 

Daer  reaponae:  None. 

JOB  '  '  IS  EXECUTING 
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Explenetion: 

1.  A  TMOD  was  attempted  during  a  fly  (or  chk)  proceaa  againat  a 
job  Chat  ia  executing.  Thia  ia  the  first  of  two  aeaaagea  (ref 
3159,  TNOD  not  invoked). 

2.  An  update,  other  than  poating  an  end  or  ABEND,  was  attenpted 
againat  an  executing  job  through  SAMUPD(P).  Thia  ia  the  firat  of 
two  aeaaagea  (ref  3118). 

Syatea  action! 

1.  The  TMOD  is  not  invoked.  Processing  continues. 

2.  The  data  statement  (card)  ia  rejected.  Processing  continues. 
Uaer  response} 

1.  None. 

2.  Post  an  end,  or  cleir  the  job,  before  re-entering  the  update. 

1982  JOB  START  HAS  OCCURRED. 

Explanation:  An  atteapt  was  made  to  post  an  early  start  time  to 
a  job  with  a  start  tiae  already  posted.  This  is  the  first  of  two 
messages  (ref  3118). 

System  action:  Data  stateawnt  (card)  is  rejected.  Processing 
continues. 

User  response:  Clear  the  job  (RM-CLEAR)  before  posting  an  early 
start. 

1983  JOB  ' _ '  BACKS  OF?  TO  JOB  ' _ ’ 

Explanation:  A  dependency  error  has  been  encountered  in  the 

simulation  process.  Thia  is  the  firat  of  three  messages  (ref 
3183  and  318A)  showing  the  back-off  of  dependencies  until  a  job 
is  found  depending  on  the  first  job  referenced  in  this  message, 
which  would  create  a  loop  if  not  intercepted. 

System  action:  Processing  ia  terminated. 

Uaer  response:  ,  Correct  one  or  more  jobs'  dependency  fields  and 
re-run. 

1993  JOB  ' _ '  HAS  RELEASED 

Explanaton:  A  job  has  been  released  for  execution  by  the  S AMEND 
program. 
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System  action:  Processing  continues. 

User  response:  None. 

JOB  ' _ '  ms  RELEASED  OUTSIDE  KMS 

Explanation:  A  job  entry  on  the  running  matrix,  to  be  updated 
with  completion  data,  did  not  have  a  start  posted  to  it. 

System  action:  The  end  or  ABEND,  and  stop  time  ere  posted.  No 
elapsed  time  is  computed.  A  scan  is  initiated  against  the  run¬ 
ning  sutrix  for  jobs  to  release. 

User  response:  None. 

JOB  ' _ *  CURRENT  SHARE  USER  ON  FILE  ' _ 1 

Explanation:  When  a  job  under  MMS  control  ABENDS  and  is  using 
f ile(s)  in  share  mode,  all  other  active  users  of  the  file(s)  in 
share  mode  are  displayed  to  the  user. 

System  action:  Processing  continues. 

User  response:  None. 

JOB  ' _ '  CAN  BE  RELEASED 

Explanation:  During  the  execution  of  the  SAMSCAN  function 
against  a  "termed"  running  matrix,  a  job  is  found  as  available 
for  release. 

System  action:  The  job  is  not  released.  Processing  continues. 
User  response:  None. 

MAX  NUMBER  OF  JOBS  TO  BE  RUN  EXCEEDS  555 

Explanation:  An  attempt  has  been  made  to  fly  (chk)  add  jobs  to 
the  running  matrix,  bringing  the  total  maber  of  jobs  over  555. 

System  action:  Processing  continues,  but  if  executing  in  batch 
mode,  the  fly  (or  chk)  and  simulation  functions  are  terminated. 

User  response:  Correct  and  re-enter. 

MAX  NUWER  OF  JOBS  TO  BE  FLY  DELETED  EXCEEDS  555 

Explanation:  An  attempt  has  been  made  to  fly  delete  more  than 
555  jobs.  This  exceeds  the  number  of  jobs  possible  on  the  run¬ 
ning  matrix. 
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System  eetion:  Processing  continues,  but  if  executing  in  batch 
mode,  the  fly  and  simulation  functions  are  terminated. 

User  response:  Correct  and  re-enter.  - 

2101  SAM  PROCESSING  HAS  TERMINATED  WITH  ERRORS 

Explanation:  A  program  in  the  SAM  portion  of  MMS  has  termin¬ 
ated  because  of  error(s)  already  reported  to  the  user. 

System  action:  Processing  is  terminated. 

User  response:  Review  error  messages,  correct,  and  rerun. 

2124  SAM  PROCESSING  HAS  COMPLETED  NORMALLY 


*  Explanation:  A  program  in  the  SAM  portion  of  MMS  has  completed 

normally. 

System  action:  Processing  is  cong>leted. 

User  response:  None. 

2721  CHANGE  DATA  NOT  SPECIFIED 


Explanation:  A  required  keyword  was  specified  on  a  data  state¬ 
ment,  but  no  optional  keywords  followed. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response;  Correct  and  re-enter. 

2858  ACTION  OF  CHANGE  MUST  BE  SPECIFIED 


Explanation:  An  action  other  than  CHANGE  was  specified  on  a  data 
statement  (card)  for  a  DEVICES  or  ENV  update. 

System  action:  The  data  statement  (card)  is  rejected.  Process¬ 
ing  continues. 

User  response:  Correct  and  re-enter. 

2959  SIMULATOR  NOT  INVOKED 

Explanation:  One  or  more  errors  have  been  encountered  in  the 

execution  of  SASSSIMP,  SASSRUNP,  SASSFLYP,  SASSCHKP,  or  SAMSIMP 
that  were  critical  enough  to  terminate  or  bypass  simulation. 

System  action:  Processing  is  terminated. 

User  response:  Review  and  correct  errors  encountered  by  SASS 
rerun. 
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3100  xxxx  xxxx  xm  xxxx  xxxx 

Explanation:  This  Kiatge  it  used  by  the  SAMEND  program  to 
display  blocks  of  core  that  are  contiguous  in  the  system.  It  is 
message  two  and  three  of  three  messages  (ref  3586). 

System  action:  Processing  continues. 

Osar  response:  None. 

3100  IN ITS  EMPTY 

Explanation:  Dependency  errors  have  occurred  in  the  simulation 

processing  preventing  the  release  of  the  unsimulated  jobs.  This 
is  the  second  of  three  messages  (ref  1416  and  3136). 

System  action:  Processing  is  terminated. 

User  response:  Review  error  messages.  Correct  the  jobs 

dependency  fields  in  the  master  matrix  and  rerun. 

3105  INITIATORS  NOT  FOUND  AVAILABLE 

Explantion:  No  class  A  initiators  were  found  that  were  available 
for  releasing  a  job. 

System  action:  Processing  continues. 

User  response:  Add  class  A  to  more  initiators;  or  no  action  is 
required. 

3118  REQUEST  IS  INVALID 

Explanation:  An  update  request  through  SAMUPD(P),  though  syntac¬ 
tically  correct,  is  invalid  because  of  conflicting  conditions  on 
the  running  matrix.  This  is  the  second  of  two  smssages  (ref 
1976,  1650,  1967,  and  1982). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 


User  response:  Take  action  as  appropriate. 

3135  SCAN  PROCESSING  BYPASSED 

Explanation:  The  scan  of  the  running  matrix,  for  jobs  to 

release,  is  bypassed  because  the  running  matrix  has  been  quiesced 
(termed). 

System  action:  Processing  continues. 

User  response:  None. 
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TOTAL  NUMBER  07  JOBS  NOT  RUN 


Explanation!  Dependency  error*  have  occurred  in  the  simulation 
processing.  This  is  the  third  of  three  messages  (ref  1416  and 
3100  UNITS  EMPTY)). 


System  action:  Processing  is  terminated. 

User  response!  Review  error  messages;  correct  dependency  errors; 
and  rerun. 

JOB  ' _ '  EXCEEDS  MAXIMUM 

Explanation:  After  the  aaximua  number  of  jobs  to  be  run,  fly 
added,  or  fly  deleted  has  been  reached,  any  additional  jobs  spe¬ 
cified  will  be  displayed. 

Systeai  action:  Processing  continues,  but  if  executing  in  batch 
mode,  the  run  or  fly  and  simulation  functions  are  terminated. 


User  response!  Correct  and  re-enter. 

FILE  ' _ '  REQUESTED  AS  SHARE/UPDATE/EXCL-USE/REFERENCE 

Explanation!  A  job  has  been  selected  as  available  for  release  in 
the  simulation  or  actual  system  scheduling  process,  but  a  file 
requested  by  the  job  is  already  in  use  in  an  incompatible  mode. 
Incompatible  requests  and  current  use  are: 


Incompatible  requests 
share 
update 

exclusive-use 


Current  use 

update  exclusive-use 

share  update  exclusive-use 

reference  update  share 
exclusive-use 


reference 


exclusive-use 


This  is  the  second  of  three  messages  (ref  1973  and  3150). 
System  action:  Processing  continues. 

User  response:  Nona. 
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FILE  ' _ '  CURRENTLY  BEING  SHARED /UPDATED /REFEENCED/EXCL- OS  ED 

Explanation;  A  job  has  baan  selected  as  available  for  release  in 
the  simulation,  or  actual  system  scheduling  process,  but  a  file 
requested  by  the  job  is  already  in  use  in  an  incompatible  mode. 
This  is  the  third  of  three  messages  (ref  1973  and  3149). 

System  action;  Processing  continues. 

User  response:  None. 

DELETE  NOT  INVOKED 

Explanation:  A  job  specified  on  the  data  statement  (card)  to  be 
fly  deleted  is  represented  on  the  running  matrix  as  still  execut¬ 
ing.  The  job  is  not  deleted  from  the  running  matrix.  This  is 
the  second  of  two  messages  (ref  1939). 

System  action:  Processing  continues. 

User  response:  Either  delete  the  job  through  SAMUPD(P),  or  post 
a  completion  to  the  job  through  SAMEND(P)  or  SAMUPD(P).  In  the 
latter  option,  SASS  will  automatically  delete  the  job  from  the 
running  matrix  in  the  next  execution  of  SASSFLYP. 

POSTING  WILL  BE  BYPASSED 

Explanation:  The  job  entry  in  the  running  matrix  has  already 
been  posted  as  complete  or  ABENDed. 

System  action:  No  posting  to  the  run  matrix  is  done.  A  scan 
against  the  running  matrix  is  initiated  for  jobs  to  release. 

User  response:  It  may  be  necessary  to  remove  file  locks,  or  post 
normal  completion  through  SAMUPD(P),  if  the  job  had  previously 
ABENDed. 

NOT  POSTED  TO  MMATRIX 

Explanation:  In  the  execution  of  the  fly  (chk)  function,  an 
ended  or  ABENDed  job  on  the  running  matrix  was  not  posted  to  the 
master  matrix  because  the  job  did  not  exist  on  the  master  matrix, 
the  job  ABENDed  prior  to  a  normal  end,  the  running  matrix  jobname 
did  not  equal  the  master  matrix  jobname,  or  the  job  was  started 
outside  of  KMS  control.  This  is  the  second  of  tvo  messages  (ref 
1928,  1964,  1966,  or  1968  (Job  processed  to  EOJ  outside  SASS). 

System  action:  Processing  continues. 

User  response:  None 
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DELETED  FROM  RMATRIX 

Explanet  ion  :  In  the  execution  of  the  fly  (or  chk)  function,  a 
normally  completed  job  will  be  delated  from  the  running  matrix 
automatically. 

Svatem  action?  Proceeding  continuee. 

Peer  response:  None. 

INITS/ CORE/ DISK/ TAFE9/TAPE7/PRINT/PUNCH  REQUESTED  ' _ ' 

Explanation:  A  job  hae  been  eelected  ae  available  for  releaee  in 
the  simulation,  or  actual  aystem  scheduling  process,  but  the 
core,  initiator,  or  devices  required  by  the  job  are  not 
available.  The  amount  or  number  requested  is  displayed.  This  is 
the  second  of  three  messages  (ref  1973  and  3172). 

System  action:  Processing  continues. 

User  response:  None. 

INITS/CORE/DISK/TAPE9/TAPE7 /PRINT/PUNCH  AVAILABLE 

Explanation:  A  job  has  been  selected  as  available  for  release  in 
the  simulation  or  actual  system  scheduling  process,  but  the  core, 
initiator,  or  devices  required  by  the  job  are  not  available.  The 
amount  or  number  available  is  displayed.  This  is  the  third  of 
three  messages  (ref  1973  and  3171). 

System  action:  Processing  continues. 

User  response:  None. 

PARAKTER  BYPASSED 

Explanation:  A  field  for  inquiry  on  the  data  statement  input  to 
the  MMS  inquiry  program  was  in  error.  The  field  is  bypassed. 

System  action:  Processing  continues. 

User  response:  Correct  and  re-enter. 

POSTING  HAS  OCCURRED 

Explanation:  A  normally  completed  job,  executed  under  MK3  con¬ 
trol,  is  posted  to  the  master  matrix.  This  is  the  second  of  two 
messages  (ref  1968  (job  processed  to  EOJ). 

System  action:  Processing  continues. 

User  response:  None. 
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WHICH  BACKS  OFF  TO  JOB  ' _ ’ 

toUnrtiay  A  dependency  error  hae  Been  encountered  in  the 
simulation  procese.  This  ia  the  eecond  of  three  mu«|ci  (ref 
1983  end  3184).  This  message  will  be  diapleyed  for  every  job  in 
the  back-off  process  until  the  jobs  causing  the  dependency  loop 
are  found. 

System  action:  Processing  is  tereinated. 

Osar  response*  Correct  one  or  nore  jobs'  dependency  fields  and 
rerun. 

TAPE9(S)/TAPE7(S)/DXSK(S) /?BIHTBR(S)/POHCH(S)  -  ' _ ' 

Explanation:  In  the  execution  of  the  SAMEND  progran  the  total 

number  of  each  device  type  is  displayed.  This  ia  the  second 
through  sixth  message  (ref  3600). 

System  action:  Proceeding  continues. 

Oser  response:  None . 

REJECTS  -  ' _ ' 

Explanation:  When  the  program  SASS  and  SAMOPD  are  executing  in 
batch  mode,  the  total  number  of  input  records  rejected  is  dis¬ 
played  at  the  end  of  input  processing. 

System  action:  Processing  continues. 

Oser  response:  None . 

INACTIVE  -  ' _ ' 

Explanation:  The  total  number  of  inactive  initiators  is  dis¬ 

played  by  execution  of  the  SAMEND  program. 

System  action:  Processing  continues. 

Oser  response:  None . 

INACTIVE  CLASS  A  -  ' _ ' 

Explanation:  The  total  number  of  inactive  intiators,  vith  an 

assigned  class  A,  is  displayed  by  the  execution  of  the  SAMEND 
program. 

System  action:  Processing  continues. 

Oser  response:  None 
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3191  INACTIVE  CLASS  ' ' 

Explanet ion:  Each  inactive  initiator,  with  its  assigned  classes, 
is  displayed  by  the  execution  of  the  SAMEND  prograa. 

System  action:  Processing  continues. 

Osar  response:  None . 

3195  TOTAL  -  ' ' 

Explanation:  The  total  nuaber  of  initiators  is  displayed  by  the 
execution  of  the  SAMEND  prograa. 

Systea  action:  Processing  continues. 

User  response:  None . 

3277  OPTIMUM  SYSTEM  UTILIZATION  NOT  EFFECTED  AT  ' _ * 

Explanation:  In  the  simulation  or  actual  systea  scheduling  pro¬ 

cess,  more  jobs  are  available  for  release  than  there  are  initia¬ 
tors  available.  The  tiae  is  displayed. 

Systea  action:  Processing  continues. 

User  response:  ) 

1.  Increase  the  nuaber  of  initiators  for  the  simulation  (maximum 
of  10). 

2.  Assign  a  class  A  to  more  system  initiators. 

3382  OVERFLOW  IN  TABLE  ' _ '  HAS  OCCURRED 

Explanation:  One  of  two  fixed  tables  has  been  exceeded  in  the 

dependency  optimizer  process. 

Systea  action:  Processing  is  terminated. 

User  response:  Contact  USADAROOM  ALMSA  (DRXAL-TA)  i»ediately. 

3382  OVERFLOW  IN  TABLE  ' _ '  HAS  OCCURRED  FOR  JOB  ' _ ' 

Explanation:  The  master  matrix  cross-reference  program  has 

exceeded  the  limit  of  its  fixed  table  of  extracted  dependent  jobs 
for  a  job  being  cross-referenced. 

j 

Systea  action:  The  jobs  extracted,  up  to  the  limit,  for  that  job 
will  be  reported.  Processing  continues. 

User  response:  Contact  USADAROOM  ALMSA  ( DRXAL-TA)  immediately. 

) 
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3475  AVAILABLE  SYSTEM  RESOURCES  AT  ' _ ' 

Explanation:  When  the  S AMEND  prograa  is  executed,  the  eveileble 
•pa tea  resource*  are  displayed  This  aessage,  the  £irst  of 
several,  displays  tha  tias  of  exacutioa. 

System  action:  Processing  continues. 

User  response:  None . 

3586  CONTIGUOUS  BLOCKS  OP  CORE 

Explanation:  This  is  the  header  ass  sage  used  by  the  8AMEND 

prograa  to  display  blocks  of  core  that  are  continquous  in  the 
systea.  It  is  the  first  of  three  aasaages  (ref  3100). 

Systea  action:  Processing  continues. 

User  response:  None . 

3600  DEVICES 

Explanation:  This  is  the  header  message  used  by  the  S  AMEND 

prograa  to  display  devices  available  in  the  systea.  It  is  the 

first  of  six  messages  (ref  3187). 

Systea  action:  Processing  continues. 

User  response:  None . 

3700  INITIATORS 

Explanation:  This  is  the  header  aessage  used  by  the  S AMEND 

prograa  to  display  total,  active,  inactive,  and  inactive  by  class 
initiators  in  the  systea  (ref  3195,  3189,  3190,  and  3191). 

4549  THERE  IS  NO  CURRENT  SHARE  USER  IN  PILE  ' _ ' 

Explanation:  When  a  job  ABENDS,  and  is  using  a  file  in  the  share 
aode,  a  scan  is  initiated  against  the  running  Mtrix  for  active 
jobs  using  the  file  in  the  share  mode.  If  none  are  found,  this 

aessage  is  displayed. 

System  action:  Processing  continues. 

User  response:  None , 

4682  PRIOR  LOCK/ XL OCR  HAS  OCCURRED  ON  PILE  ' _ ' 

Explanation:  A  lock  or  XLOCK  has  been  placed  on  a  file  through 
an  earlier  job  ABENDing  (through  SAMEHD),  or  by  a  user  request 
(SAMUPD),  asking  it  unnecessary  to  lock  it  because  of  the  current 
job  ABENDing. 


P-33 


Cl,  Vol.  15,  CCSSOI  18-320 


Appendix  F— Continued 
System  actions  Processing  continues. 

Dser  response:  None. 

4863  LOCK  ON  FILE  ' _ '  WILL  BE  INITIATED/REMOTED 

Explanation: 

1.  When  a  job  ABENDS,  the  SAMEND  program  will  place  a  lock  on 
all  files  used  by  the  program  that  were  in  update,  share,  or 
exclusive-use  mode. 

2.  When  restarting  an  ABENDed  job,  the  SAMEND  program  will 
remove  the  lock  on  files  used  by  the  program  that  were  in  update, 
share,  or  exclusive-use  mode.  A  scan  is  initiated  against  the 
running  matrix  to  set  the  current  file  status  and  number  of  users. 

System  action:  Processing  continues. 

User  response:  None. 

5102  OTHER  KEYWORD ( S )  NOT  PERMITTED  WITH  ND 

Explanation:  A  request  to  update  the  number  of  devices  for  a 

file  (ND)  contained  other  keyword(s). 

System  action:  Data  statement  (card)  is  rejected.  Processing 
continues. 


User  response:  Correct  and  re-enter. 
5232  EXTRANEOUS  ' , '  IN  COL  ' _ ' 


* 


Explanation:  A  cornua  was  encountered  on  a  data  statement  input 
to  the  MMS  inquiry  program  with  no  preceding  unprocessed  inquiry 
field. 


System  action:  Processing  continues. 

User  response:  None. 

5309  PARAMETER  STARTING  IN  COL  ' _ '  EXCEEDS  MAX  LENGTH 

*  Explanation?  A  parameter  on  the  input  data  statement  to  the  MMS 

inquiry  program  exceeds  the  maxima  length.  The  parameter  is 
bypassed. 

System  action:  Processing  continues. 

User  response:  Correct  and  re-enter. 
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5318 


5341 


* 


5482 


PARAMETER  ' _ 1  IS  INVALID 

Explanation:  A  parameter  on  the  jLnput  data  statement  to  the  MMS 
inquiry  program  is  invalid.  The  parameter  is  bypassed. 

System  action:  Processing  continues. 

Dser  response:  Correct  and  re-enter. 

PARAMETER  ' _ '  EXCEEDS  MAXIMUM 

Explanation:  The  parameter  on  the  input  data  statement  to  the 
MMS  inquiry  program  exceeds  the  maximum  of  50  inquiries  allowed. 

System  action:  Processing  continues. 

User  response:  Enter  a  /*. 

SORT  FAIL  HAS  OCCURRED 


Explanation:  SORT-RETURN  is  not  equal  to  zero. 

System  action:  Processing  is  terminated. 

User  response:  Contact  USADARCOM  ALMS A  (DRXAL-TA) 

5568  TOTAL  NUMBER  OP  JOBS  PROCESSED  TO  EOJ  - 

Explanation:  Whenever  the  SAMRPT  program  is  executed  in  batch 

mode,  and  the  synfcolic  FUNRSHN  specifies  RPTALL,  then  the  total 
number  of  jobs  processed  to  normal  cosq>letion  is  displayed  at  the 
end  of  processing. 

System  action:  Processing  continues. 

User  response:  None. 

5587  TOTAL  INPUT  -  1 _ ' 

Explanation:  When  the  programs  SASS  or  SAMUPD  are  executing  in 
batch  mode,  the  total  number  of  input  records  is  displayed  at  the 
end  of  input  processing. 
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.Appendix  G 
MMS  COMPLETION  COOES 


Code 

Definition 

Action  reauired 

100 

Normal  completion 

None 

104 

No  input  data 

Rerun  with  input  data. 

112 

Simulation  terminated 

Correct  errors  reported 
and  rerun. 

116 

Parameter  error 

Correct  parameter  and 
rerun. 

120 

Sort  failed 

Contact  SMCO. 
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DREAMS  REAMS  INFORMATION 


Item 

001 

002 


003 

004 


005 


006 


*007 


JM-XXXX 


Description 

Close  the  reader  (usually  00C) 

Start  DSEAMSR.  This  will  scratch 
data  sets  on  the  spool  pack. 
Automatically  start  DREAMS  that 
allocates  a  reader  (ucually  RDR 
00C) . 


To  close  the  DREAMS  reader: 

1.  Have  end  of  file  on. 

2.  Read  one  slash-slash  card. 

To  read  in  one  job  or  the  last  job 
in  a  string  of  jobs: 

1.  Read  one  slash-asterisk  card. 

2.  Have  end  of  file  on. 

After  reading  in  50  contiguous  jobs 
the  reader  mill  automatically  close 
itself. 

The  operator  must: 

1.  Clear  the  51  job  and  have  the 
job  ready  to  be  read  in. 

2.  Start  DREAMSR  again  as  shown  in 
item  001 . 

If  non-contiguous  jobs  are  being  read 
in,  and  the  total  number  of  jobs  exceeds 
35,  then  DREAMS  will  close  itself,  reset 
its  job  count  to  1,  and  automatically 
restart. 

Since  the  DREAMS  reader  places  all 
jobs  on  the  spool  pack  the  operator  may 
need  to  start  a  specific  job  that  is 
not  under  MMS  control,  (not  on  the 
RMATRIX) . 

The  operator  would  start  RDRSAM. 
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Appendix  I 
ABEND  CODES 


** 

M  M  S  ABE 

N  D  S 

** 

** 

WWW 

** 

** 

** 

ABEND  CODE 

P&OB  MODULE 

DESCRIPTION 

** 

** 

** 

** 

2001 

APCACCG 

REGION  OVERRIDE  ERROR 

** 

** 

2002 

APCABBA4 

NO  JES2  ADDS  SPACE  FOUND 

** 

** 

2003 

APCABBA4 

GETMAII/SIB  FAILED  CSA 

** 

** 

2003 

APCABBA6 

GETMA1N/SRB  FAILED  CSA 

** 

** 

2004 

APCACCI 

REGION  OVERRIDE  PROBLEM 

** 

** 

2006 

APCACCI 

OVER  200  DATA  SETS  PASSED 

** 

** 

2007 

APCACC6 

NO  TCAM  ADDR  SPACE  FOUND 

** 

** 

2010 

APCACC4 

BAD  OPEN  ON  INPUT  FILE 

** 

** 

2011 

APCACC4 

BAD  OPEN  ON  OUTPUT  FILE 

** 

** 

3000 

APFABBB 

CPU  ID  NOT  IN  SCHEDULING 

** 

** 

NETWORK 

** 

** 

3001 

APCACCC 

DYNAMIC  ALLOCATION  FAILURE 

** 

** 

3002 

APCACCC 

UNABLE  TO  DEALLOCATE 

** 

** 

3100 

APFAAS1 

BAD  OPEN  ON  NETWORK  FILE 

** 

** 

3200 

APFAAB1 

DATA  MISSING  ON  NETWORK  FILE** 

** 

3300 

APFAAB1 

BAD  OPEN  ON  NETWORK  FILE 

** 

** 

3400 

APFAAB1 

DATA  MISSING  ON  JOB  FILE 

** 

** 

3500 

APFAABl 

BAD  OPEN  ON  JOB  FILE 

** 

** 

3550 

APFAABl 

LOGIC  ERROR 

** 

** 

3600 

APFAAB2 

OPEN  ERROR  ON  RUN  MATRIX 

** 

** 

3700 

APFAAB2 

DATA  MISSING  ON  RUN  MATRIX 

*W 

** 

3800 

APFAAB2 

BAD  OPEN  ON  BMATRIX 

** 

** 

3800 

APFAAB3 

BAD  OPEN  ON  DMATRIX 

*+ 

** 

3810 

APFAAB3 

BAD  OPEN  ON  DMATRIX 

Irk 

** 

3850 

APFAAB2 

LOGIC  ERROR 

** 

** 

4093 

APCAOB 

PDS  DCB  ERROR  (CHK  R15) 

M 

** 

★  * 
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